uv sync

VLM_BASE_URL=https://api.openai.com/v1
VLM_API_KEY=sk-xxx
VLM_MODEL_ID=gpt-4o

# HTTP（远程，默认）—— 端点 http://<host>:<port>/mcp
uv run python -m vision_mcp

# stdio（本地，如作为 Claude Desktop / Cursor 子进程）
MCP_TRANSPORT=stdio uv run python -m vision_mcp

src/vision_mcp/
├── server.py        # FastMCP 实例 + 注册工具 + 启动
├── config.py        # 环境变量配置（pydantic-settings）
├── schemas.py       # 数据模型（ImageInput/BBox/Detection 等）
├── vlm/
│   ├── client.py    # AsyncOpenAI 封装 + JSON 解析
│   └── prompts.py   # 四场景 system prompt
├── image/
│   ├── io.py        # 统一加载（path/base64/url）+ EXIF 校正
│   ├── meta.py      # 元信息
│   ├── resize.py    # 缩放
│   ├── crop.py      # 裁剪
│   ├── transform.py # 旋转/镜像
│   ├── compose.py   # 拼接
│   └── annotate.py  # 标注（中文字体回退）
└── tools/
    ├── vision.py    # 4 个 VLM 工具实现
    └── image_ops.py # 图像辅助工具实现

uv run pytest

{
  "mcpServers": {
    "vision-mcp": {
      "url": "http://127.0.0.1:8000/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}