image-recongnition-mcp

图像识别 MCP 服务

一个 Model Context Protocol（MCP）服务，使用 OpenAI 的视觉模型提供 AI 驱动的图像识别和描述功能。

概述

此 MCP 服务通过简单的基于 URL 的接口，让 AI 助手能够分析和描述图像。它利用 OpenAI 强大的视觉模型，提供详细的图像描述，让你轻松将图像分析功能集成到 AI 工作流中。

功能

• 图像分析：分析 URL 中的图像并获取详细描述
• OpenAI 集成：使用 OpenAI 最新的视觉模型，实现准确的图像识别
• MCP 协议：完全兼容 Model Context Protocol 标准
• TypeScript：使用 TypeScript 构建，确保类型安全并提供更好的开发体验
• 简单的 API：易于使用的图像描述请求接口

安装

先决条件

• Node.js 18+
• npm 或 yarn
• OpenAI API 密钥

MCP 客户端配置

要在 MCP 客户端中使用此服务，请添加以下配置：

{
  "mcpServers": {
    "image-recognition": {
      "command": "npx",
      "args": ["-y", "@mcp-s/image-recognition-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-actual-openai-api-key-here"
      }
    }
  }
}

⚠️ 重要： 必须在 env 部分填写你的 OpenAI API 密钥——这是 MCP 服务正常运行的唯一方式。

用法

可用工具

describe-image

分析 URL 中的图像并提供详细描述。

参数：

• imageUrl（字符串）：要分析的图像 URL

示例：

{
  "tool": "describe-image",
  "arguments": {
    "imageUrl": "https://example.com/image.jpg"
  }
}

响应：

{
  "content": [
    {
      "type": "text",
      "text": "The image shows a beautiful sunset over a mountain landscape with vibrant orange and pink colors in the sky..."
    }
  ]
}

与 AI 助手集成

此 MCP 服务可与多种支持 MCP 协议的 AI 助手集成，例如：

• Claude Desktop
• 其他兼容 MCP 的 AI 系统

开发

项目结构

image-recognition-mcp/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

错误处理

此服务针对以下情况实现了稳健的错误处理：

• 无效的图像 URL
• 网络连接问题
• OpenAI API 错误
• 无效的输入参数

故障排除

常见问题

服务无法启动或无法正常工作：

• ✅ 检查是否已设置 OpenAI API 密钥：这是问题的首要原因

  echo $OPENAI_API_KEY  # Should show your API key
  

• ✅ 确认 API 密钥有效：直接使用 OpenAI 的 API 进行测试
• ✅ 检查 API 密钥是否有足够的额度：确保你的 OpenAI 账户有可用额度

“身份验证失败”错误：

• 缺少 OpenAI API 密钥或密钥无效
• 设置环境变量：export OPENAI_API_KEY="your-key"

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

许可证

此项目采用 ISC License。详情请参阅 LICENSE 文件。

支持

如需支持，请在 GitHub 仓库中提交 issue，或联系维护者。