Image Recognition MCP Server

图像识别MCP服务器

一个模型上下文协议（MCP）服务器，利用OpenAI的视觉模型提供基于人工智能的图像识别和描述功能。

概述

这款MCP服务器使AI助手能够通过一个基于简单URL的界面来分析和描述图像。它利用了OpenAI的强大视觉模型来提供详细的图像描述，从而轻松地将图像分析功能集成到您的AI工作流程中。

特点/功能

• 图像分析从URL分析图像并获取详细描述
• OpenAI 集成使用OpenAI的最新视觉模型进行准确的图像识别
• MCP协议完全兼容模型上下文协议标准
• 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协议的人工智能助手集成，例如：

• Claude Desktop（可译为“Claude桌面版”）
• 其他兼容MCP的人工智能系统

发展

项目结构

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. 为仓库创建分支
2. 创建一个特性分支（git checkout -b feature/amazing-feature)
3. 提交您的更改（git commit -m 'Add some amazing feature')
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开一个拉取请求

许可证

这个项目遵循ISC许可证授权。请参阅 LICENSE 文件中有详细信息。

支持

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