image-mcp-server

日本語の README

<a href="https://glama.ai/mcp/servers/@champierre/image-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@champierre/image-mcp-server/badge" alt="Image Analysis MCP Server" /> </a>

一个 MCP 服务器，接收图像 URL 或本地文件路径，并使用 GPT-4o-mini 模型分析图像内容。

特性

• 接收图像 URL 或本地文件路径作为输入，并提供图像内容的详细分析
• 使用 GPT-4o-mini 模型进行高精度图像识别和描述
• 图像 URL 有效性检查
• 从本地文件和 Base64 编码加载图像

安装

通过 Smithery 安装

要通过 Smithery 自动安装用于 Claude Desktop 的图像分析服务器：

npx -y @smithery/cli install @champierre/image-mcp-server --client claude

手动安装

# 克隆仓库
git clone https://github.com/champierre/image-mcp-server.git # 或您 fork 的仓库
cd image-mcp-server

# 安装依赖
npm install

# 编译 TypeScript
npm run build

配置

要使用此服务器，您需要一个 OpenAI API 密钥。设置以下环境变量：

OPENAI_API_KEY=your_openai_api_key

MCP 服务器配置

要与 Cline 等工具一起使用，请将以下设置添加到您的 MCP 服务器配置文件：

对于 Cline

将以下内容添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

对于 Claude Desktop App

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "image-analysis": {
      "command": "node",
      "args": ["/path/to/image-mcp-server/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key"
      }
    }
  }
}

用法

配置 MCP 服务器后，以下工具可用：

• analyze_image: 接收图像 URL 并分析其内容。
• analyze_image_from_path: 接收本地文件路径并分析其内容。

用法示例

从 URL 分析：

Please analyze this image URL: https://example.com/image.jpg

从本地文件路径分析：

Please analyze this image: /path/to/your/image.jpg

注意：指定本地文件路径

使用 analyze_image_from_path 工具时，AI 助手（客户端）必须指定在此服务器运行的环境中有效的文件路径。

• 如果服务器在 WSL 上运行：
  • 如果 AI 助手具有 Windows 路径（例如，C:\...），则需要将其转换为 WSL 路径（例如，/mnt/c/...），然后再将其传递给该工具。
  • 如果 AI 助手具有 WSL 路径，则可以按原样传递它。
• 如果服务器在 Windows 上运行：
  • 如果 AI 助手具有 WSL 路径（例如，/home/user/...），则需要将其转换为 UNC 路径（例如，\\wsl$\Distro\...），然后再将其传递给该工具。
  • 如果 AI 助手具有 Windows 路径，则可以按原样传递它。

路径转换是 AI 助手（或其执行环境）的责任。 服务器将尝试按原样解释接收到的路径。

注意：构建期间的类型错误

运行 npm run build 时，您可能会看到一个关于 mime-types 模块缺少 TypeScript 类型定义的错误 (TS7016)。

src/index.ts:16:23 - error TS7016: Could not find a declaration file for module 'mime-types'. ...

这是一个类型检查错误，由于 JavaScript 编译本身成功，因此不会影响服务器的执行。 如果您想解决此错误，请将类型定义文件作为开发依赖项安装。

npm install --save-dev @types/mime-types
# or
yarn add --dev @types/mime-types

开发

# 在开发模式下运行
npm run dev

许可证

MIT