AI导哈

图像分析服务器

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

  • by champierre
  • JavaScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 champierre/image-mcp-server

使用说明

映像mcp服务器

日语学习README

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

特性

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面图像分析服务器 史密瑟里:

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

手动安装

# Clone the repository
git clone https://github.com/champierre/image-mcp-server.git # or your forked repository
cd image-mcp-server

# Install dependencies
npm install

# Compile TypeScript
npm run build

配置

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

OPENAI_API_KEY=your_openai_api_key

MCP服务器配置

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

对于克莱恩

添加以下内容 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分析：

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，您可能会看到一个关于缺少TypeScript类型定义的错误（TS7016） mime-types 模块。

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

发展

# Run in development mode
npm run dev

许可证

麻省理工学院

相关 MCP