Describes images using Anthropic and OpenAI vision APIs, with optional Tesseract OCR.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add image-recognition --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env OPENAI_MODEL='<OPENAI_MODEL>' --env VISION_PROVIDER='<VISION_PROVIDER>' -- python -m image_recognition_server.server~/.codex/config.toml
[mcp_servers.image-recognition]
command = "python"
args = ["-m", "image_recognition_server.server"]
env = { OPENAI_API_KEY = "<OPENAI_API_KEY>", OPENAI_MODEL = "<OPENAI_MODEL>", VISION_PROVIDER = "<VISION_PROVIDER>" }
# codex mcp add image-recognition --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env OPENAI_MODEL='<OPENAI_MODEL>' --env VISION_PROVIDER='<VISION_PROVIDER>' -- python -m image_recognition_server.server~/.cursor/mcp.json
{
"mcpServers": {
"image-recognition": {
"command": "python",
"args": [
"-m",
"image_recognition_server.server"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"OPENAI_MODEL": "<OPENAI_MODEL>",
"VISION_PROVIDER": "<VISION_PROVIDER>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"image-recognition": {
"type": "stdio",
"command": "python",
"args": [
"-m",
"image_recognition_server.server"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"OPENAI_MODEL": "<OPENAI_MODEL>",
"VISION_PROVIDER": "<VISION_PROVIDER>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"image-recognition": {
"command": "python",
"args": [
"-m",
"image_recognition_server.server"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"OPENAI_MODEL": "<OPENAI_MODEL>",
"VISION_PROVIDER": "<VISION_PROVIDER>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"image-recognition": {
"command": "python",
"args": [
"-m",
"image_recognition_server.server"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"OPENAI_MODEL": "<OPENAI_MODEL>",
"VISION_PROVIDER": "<VISION_PROVIDER>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"image-recognition": {
"command": "python",
"args": [
"-m",
"image_recognition_server.server"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"OPENAI_MODEL": "<OPENAI_MODEL>",
"VISION_PROVIDER": "<VISION_PROVIDER>"
}
}
}
}Environment variables
OPENAI_API_KEYOPENAI_MODELVISION_PROVIDER
Replace the placeholders with your own credentials and keep them out of version control.