Get Best Image

MCP映像服务器

一个智能MCP（模型上下文协议）服务器，可以搜索图像、标记图像、将图像组合成合成图像，并使用谷歌的Gemini 2.0 Flash AI为您的查询选择最佳匹配。

特性

• 🔍 图像搜索：搜索多个来源（Unsplash、Pexels，并回退到Lorem Picsum）
• 🏷️ 智能标签：用黑色边框标记每个图像（1-20），以便于识别
• 🖼️ 图像合成：将所有图像合并到一个网格视图中
• 🤖 AI选择：使用谷歌的Gemini 2.0 Flash智能选择最匹配的图像
• 📦 Base64输出：以base64格式返回图像，便于集成

安装

1. 克隆或下载此存储库

1. 安装依赖项：

   npm install

1. 复制环境模板：

   copy .env.example .env

1. 编辑 .env 并添加您的API密钥：

   GOOGLE_AI_API_KEY=your_google_ai_api_key_here
   UNSPLASH_ACCESS_KEY=your_unsplash_access_key_here
   PEXELS_API_KEY=your_pexels_api_key_here

获取API密钥

谷歌人工智能API密钥（人工智能选择必需）

1. 首选 谷歌人工智能工作室
2. 创建新的API密钥
3. 将其添加到您的 .env 文件为 GOOGLE_AI_API_KEY

Unsplash API密钥（可选，但建议使用）

1. 首选 Unsplash开发者
2. 创建新应用程序
3. 获取您的访问密钥
4. 将其添加到您的 .env 文件为 UNSPLASH_ACCESS_KEY

Pexels API密钥（可选但推荐）

1. 首选 Pexels API
2. 创建一个免费帐户并获取您的API密钥
3. 将其添加到您的 .env 文件为 PEXELS_API_KEY

用法

发展模式

npm run dev

构建并运行

npm run build
npm start

与Claude Desktop一起使用

将此服务器添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "mcp-image-server": {
      "command": "node",
      "args": ["C:/path/to/your/project/build/index.js"]
    }
  }
}

可用工具

search_and_select_best_image

搜索与您的查询匹配的图像，并返回AI选择的最佳匹配。

参数：

• query （string，必填）：图像的搜索查询
• maxImages （数字，可选）：要搜索的最大图像数（1-20，默认值：20）

Claude中的示例用法：

"Search for the best image of a sunset over mountains"

运作原理

1. 搜索：查询多个图像API（Unsplash、Pexels）以获取相关图像
2. 下载：最多下载20张图片并将其大小调整为缩略图
3. 标签：为每张图像添加带黑色边框的编号标签（1-20）
4. 编排：将所有标记的图像合并到一个网格中
5. AI分析：将合成内容与您的原始查询一起发送到谷歌的Gemini 2.0 Flash
6. 选择：AI分析每个编号的图像并选择最佳匹配
7. 返回：下载并返回所选图像为base64

错误处理

• 如果未提供API密钥，服务器将使用Lorem Picsum中的占位符图像
• 如果谷歌人工智能API不可用，它将使用后退选择算法
• 失败的图像下载将替换为占位符图像
• 所有错误都会记录到stderr进行调试

项目结构

src/
├── index.ts                    # Main MCP server entry point
└── services/
    ├── ImageSearchService.ts   # Handles image search from various APIs
    ├── ImageProcessingService.ts # Processes and combines images
    └── AISelectionService.ts   # Uses Google AI for selection

发展

• npm run dev -在开发模式下自动重启运行
• npm run build -将TypeScript构建为JavaScript
• npm run clean -清理构建目录

许可证

MIT许可证

贡献

请随时提交问题和增强请求！