{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hjfbwfqg8g4v","handle":"mcp-vision-gateway","url":"https://wellknown.network/agents/mcp-vision-gateway","links":{"self":"https://wellknown.network/agents/mcp-vision-gateway/record.json","html":"https://wellknown.network/agents/mcp-vision-gateway","markdown":"https://wellknown.network/agents/mcp-vision-gateway/record.md","api":"https://wellknown.network/api/v1/agents/mcp-vision-gateway","status":"https://wellknown.network/api/v1/agents/mcp-vision-gateway/status","claim":"https://wellknown.network/agents/mcp-vision-gateway/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-vision-gateway/claim.json","badge":"https://wellknown.network/agents/mcp-vision-gateway/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-vision-gateway/history","tools":"https://wellknown.network/api/v1/agents/mcp-vision-gateway/tools"},"ard":{"identifier":"urn:air::server:mcp-vision-gateway","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-vision-gateway","summary":"连接MCP与视觉AI模型的网关服务，支持图像处理和纯文本对话","description":"# MCP Vision Gateway (视觉AI网关) \n \n一个连接MCP与视觉AI模型的网关服务，支持纯文本对话和图像分析（通过URL或Base64编码）。 \n \n## 安装 \n \n```bash \npip install mcp-vision-gateway \n``` \n \n## 功能 \n \n### 工具 (Tools) \n \n- `vision_query`: 向AI模型发送查询，支持纯文本对话和图像分析 \n  - 支持通过URL引用图像 \n  - 支持通过image_ref引用图像（推荐方式） \n  - 支持通过base64编码传递图像 \n  - 可自定义模型、温度等参数 \n \n- `upload_image_from_url`: 从URL下载图像并获取引用ID \n  - 返回一个图像引用ID而非base64字符串 \n  - 避免传输大量base64文本 \n \n- `upload_local_image`: 从本地文件读取图像并获取引用ID \n  - 返回一个图像引用ID而非base64字符串 \n  - 避免传输大量base64文本 \n \n- `list_available_models`: 列出可用的AI模型 \n \n## 环境变量配置 \n \n设置以下环境变量来配置默认参数： \n \n- `VISION_API_BASE`: API基础URL (默认: https://api.ssopen.top) \n- `VISION_API_KEY`: API密钥 (必须设置) \n- `VISION_DEFAULT_MODEL`: 默认模型 (默认: gpt-4o) \n- `VISION_DEBUG`: 调试模式 (设置为\"true\"启用) \n \n## 在阿里云百炼中使用 \n \n在阿里云百炼平台的MCP服务配置中，使用以下JSON： \n \n```json \n{ \n  \"mcpServers\": { \n    \"vision-gateway\": { \n      \"command\": \"uvx\", \n      \"args\": [\"mcp-vision-gateway\"], \n      \"env\": { \n        \"VISION_API_KEY\": \"你的API密钥\", \n        \"VISION_DEFAULT_MODEL\": \"gpt-4o\" \n      } \n    } \n  } \n} \n``` \n \n## 本地运行 \n \n安装后，在设置好环境变量的情况下，可以通过以下方式运行： \n \n```bash \n# 使用uvx \nuvx mcp-vision-gateway \n \n# 使用包提供的命令 \nmcp-vision-gateway \n \n# 使用Python -m \npython -m mcp_vision_gateway \n``` \n \n## 使用示例 \n \n### 1. 纯文本对话 \n \n```python \nvision_query( \n    prompt=\"你好，请问今天的天气如何？\" \n) \n``` \n \n### 2. 使用URL传递图像 \n \n```python \nvision_query( \n    prompt=\"描述这张图片\", \n    image_url=\"https://example.com/image.jpg\" \n) \n``` \n \n### 3. 使用图像引用ID（推荐方式） \n \n```python \n# 从本地文件获取图像引用ID \nimage_id = upload_local_image(\"C:/Users/YourName/Pictures/photo.jpg\") \n \n# 或从URL获取图像引用ID \n# image_id = upload_image_from_url(\"https://example.com/image.jpg\") \n \n# 使用图像引用ID进行查询 \nvision_query( \n    prompt=\"描述这张图片\", \n    image_ref=image_id \n) \n``` \n \n### 4. 指定自定义参数 \n \n```python \nvision_query( \n    prompt=\"描述这张图片\", \n    image_ref=image_id, \n    model=\"gpt-4o-mini\", \n    temperature=0.5, \n    max_tokens=500, \n    api_key=\"自定义API密钥\" \n) \n``` \n \n## 许可证 \n \nMIT License","publisher":{"name":"MCP Vision Gateway Authors","url":null},"homepage":"https://github.com/yourusername/mcp-vision-gateway","repository":"https://github.com/yourusername/mcp-vision-gateway","version":"0.15","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-vision-gateway","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-understanding","name":"Image Understanding","confidence":1,"provenance":"derived"}],"categories":["media"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-vision-gateway","registry":"pypi","observedAt":"2026-10-22T12:27:00.299Z","publishedAt":"2025-05-18T17:20:35.614363Z","latestVersion":"0.15"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-vision-gateway","url":"https://pypi.org/project/mcp-vision-gateway/","firstSeenAt":"2026-09-10T05:21:49.668Z","fetchedAt":"2026-10-22T12:25:39.253Z","normalizedAt":"2026-10-22T12:25:39.253Z"}]},"firstSeenAt":"2026-09-10T05:21:49.668Z","updatedAt":"2026-10-22T12:27:00.299Z"}