Back to MCP directory
publicPublicdnsLocal runtime

mcp-server

一个基于Inspire后端图像搜索能力的MCP服务器,提供通过文本描述搜索相似图片的功能。

article

README

🚀 Inspire MCP 服务器

Inspire MCP 服务器是一个基于 Model Context Protocol 的服务器,它借助 Inspire 的后端图像搜索功能,为用户提供强大的图像搜索服务。

🚀 快速开始

可用工具

  • get-similar-images-by-description - 根据文本描述获取相似图像
    • 必需参数
      • description(字符串):图像描述
      • limit(数字):分页限制
      • offset(数字):分页偏移量

提示示例 结果示例

✨ 主要特性

  • 利用 Inspire 后端的图像搜索能力,提供高效准确的图像搜索服务。
  • 支持通过文本描述搜索相似图像,方便用户快速找到所需图像。
  • 可通过环境变量或命令行参数进行灵活配置,适应不同的运行平台。

📦 安装指南

Docker 方式

docker build -t tech-inspire/mcp .

Node 方式

npm ci && npm run build

💻 使用示例

与 Claude Desktop 配合使用

将以下内容添加到 claude_desktop_config.json 中:

Docker 配置

{
  "mcpServers": {
    "inspire": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "INSPIRE_API_BASE=<API_URL>",
        "-e",
        "IMAGES_BASE_PATH=<IMAGE_BASE_PATH>",
        "tech-inspire/mcp"
      ]
    }
  }
}

Node 配置

{
  "mcpServers": {
    "inspire": {
      "command": "node",
      "args": [
        "/path/to/repo/build/index.js",
        "--INSPIRE_API_BASE=<INSPIRE_API_BASE>",
        "--IMAGES_BASE_PATH=<IMAGES_BASE_PATH>"
      ]
    }
  }
}

📚 详细文档

配置说明

| 属性 | 详情 | |------|------| | INSPIRE_API_BASE | 后端网关的基础路径,默认值为 http://localhost:7080 | | IMAGES_BASE_PATH | 图像的基础路径,例如 https://<some-bucket>.s3.com/ |

这些变量可以根据运行平台(Docker/Node)使用环境变量或命令行参数进行配置。

📄 许可证

本 MCP 服务器采用 GNU 通用公共许可证 授权,详细信息请参阅 LICENSE 文件。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client