镜像MCP服务器

Name: 镜像MCP服务器
Author: champierre

作者：champierre6 星标更新：2025-04-04

安装使用来源：spider==github.com

项目介绍

image-mcp-server

日语的 README

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

特性

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

安装

通过Smithery安装

要通过Smithery自动安装Claude桌面的图像分析服务器：

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

手动安装

# 克隆仓库
git clone https://github.com/champierre/image-mcp-server.git # 或者你的分支仓库
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桌面应用

在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分析：

请分析这个图像URL: https://example.com/image.jpg

从本地文件路径分析：

请分析这个图像: /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: 无法找到模块'mime-types'的声明文件...

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

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

开发

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

许可证

MIT