API-MARKET MCP Server

API-MARKET MCP 服务

关于

一个模型上下文协议（MCP）服务，可将 API-Market 的端点作为 MCP 资源公开。此服务允许大模型通过 MCP 协议发现并调用由 OpenAPI 规范定义的 API。
此仓库提供对 API.market 上可用 API 的访问。该工具可免费使用，允许 Agent 自由调用所有可用 API，功能十分强大。API.market 提供了 200+ 个 API，你可以利用丰富多样的功能。

快速开始

无需克隆此仓库即可使用此 MCP 服务。只需在你选择的客户端中进行配置即可。

适用于 Claude Desktop

1. 找到或创建 Claude Desktop 配置文件：
   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
2. 添加以下配置以启用 API-Market MCP 服务：

   {
     "mcpServers": {
       "api-market": {
         "command": "npx",
         "args": ["-y", "@noveum-ai/mcp-server"],
         "env": {
           "API_HEADERS": "x-magicapi-key:your-api-key"
         }
       }
     }
   }
   

适用于 Cursor

1. 前往 File -> Preferences -> Cursor Settings。
2. 选择 MCP。
3. 点击 Add new global MCP Server。
4. 将以下内容粘贴到 mcp.json 文件中。

  {
    "mcpServers": {
      "api-market": {
        "command": "npx",
        "args": [
          "-y",
          "@noveum-ai/mcp-server",
          "--headers",
          "x-magicapi-key:<your-api-key>"
        ]
      }
    }
  }

或者，将此内容作为 mcpServers 中的第一个条目添加。

    "api-market": {
      "command": "npx",
      "args": [
        "-y",
        "@noveum-ai/mcp-server",
        "--headers",
        "x-magicapi-key:<your-api-key>"
      ]
    },

5. 对于较旧版本的 Cursor，点击 Add new MCP server 后添加以下命令

npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

从 API.market 获取 API 密钥

获取 API 密钥：

1. 登录 API.market
2. 前往个人资料并选择“My API Keys”
3. 你的 API 密钥会显示在此处

此 MCP 中的 API 列表

• GET-trueway-matrix-MatrixService-CalculateDrivingMatrix
• GET-magicapi-whisper-predictions--request_id
• POST-magicapi-whisper-whisper
• POST-capix-faceswap-upload
• POST-capix-faceswap-faceswap-v1-image
• POST-capix-faceswap-faceswap-v1-video
• POST-capix-faceswap-result
• GET-trueway-geocoding-GeocodingService-Geocode
• GET-trueway-geocoding-GeocodingService-ReverseGeocode
• POST-magicapi-dnschecker-dnschecker
• GET-magicapi-coder-predictions--request_id
• POST-magicapi-coder-coder
• POST-bridgeml-nsfw-detection-nsfw_detection
• GET-magicapi-whois-whois--domain-
• GET-magicapi-deblurer-predictions--request_id
• POST-magicapi-deblurer-deblurer
• POST-bridgeml-text-to-image-text_to_image
• GET-magicapi-period-predictions--request_id
• POST-magicapi-period-period
• GET-trueway-places-PlacesService-FindPlaceByText
• GET-trueway-places-PlacesService-FindPlacesNearby
• GET-magicapi-hair-predictions--request_id
• POST-magicapi-hair-hair
• POST-bridgeml-codellama-bridgeml-codellama
• GET-brave-brave-videos-search
• GET-brave-brave-web-search
• GET-brave-brave-images-search
• GET-brave-brave-news-search
• GET-brave-brave-suggest-search
• GET-brave-brave-spellcheck-search
• POST-magicapi-domainchecker-check_domains
• GET-trueway-routing-DirectionsService-FindDrivingRoute
• GET-trueway-routing-DirectionsService-FindDrivingPath
• POST-pipfeed-parse-extract

示例和用法

示例 1

我们可以使用 Agent 查找任意两点之间的路线

示例 2

我们可以使用 Agent 搜索任意主题的新闻，然后深入阅读相关文章

示例 3

我们可以使用 Agent 查找可用的域名

开发

向 MCP 服务添加新 API

utils 文件夹包含用于管理 API 配置、解析 OpenAPI 规范以及向 MCP 服务注册新 API 的辅助脚本。

1. 查找 OpenAPI 规范

找到你想要集成的 API 的 OpenAPI JSON。然后，在项目根目录中创建一个 json_files 文件夹，并将 OpenAPI JSON 规范添加到该文件夹中

2. 修改 OpenAPI 规范

获取 OpenAPI 规范后，使用 modify_api.py 更新规范中的路径，使其包含文件名。

python utils/modify_api.py

3. 更新 API 摘要

修改路径后，选择以下一种方式更新 API 摘要：

• 使用大模型自动缩短摘要：

python utils/LLM_summary_shortener.py 

• 手动更新摘要：

python utils/manual_summary_shortener.py 

4. 构建和测试

重新构建项目以应用更改：

npm run build

然后，使用以下命令测试新的 API 集成：

npm run inspect

5. 提交更改

如果你想将这个新 API 贡献到仓库：

• Fork 该仓库。
• 创建一个分支。
• 提交拉取请求（PR）。

6. 发布 MCP 服务（可选）

如果你想发布更改：

• 相应地更新 package.json（例如，更新版本、名称等）。
• 发布软件包：

npm publish --access public

开发工具

构建

• npm run build - 构建 TypeScript 源代码。
• npm run clean - 删除构建产物。
• npm run typecheck - 运行 TypeScript 类型检查。

开发模式

• npm run dev - 监视源文件，并在发生更改时重新构建。
• npm run inspect-watch - 运行检查器，并在发生更改时自动重新加载。

代码质量

• npm run lint - 运行 ESLint。
• npm run typecheck - 验证 TypeScript 类型。

命令行参数

npm run inspect -- \
  --api-base-url https://api.magicapi.dev/api/v1/ \
  --openapi-spec modified_files.txt \
  --headers "x-magicapi-key:your-api-key" \
  --name "my-mcp-server" \
  --version "1.0.0"

开发工作流

1. 启动开发环境：

npm run inspect-watch

2. 修改 src/ 中的 TypeScript 文件。
3. 服务将自动重新构建并重启。
4. 使用 MCP Inspector UI 测试更改。

本地调试或运行

要在本地调试或运行 MCP 服务：

1. 克隆仓库并安装依赖：

git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install

2. 构建服务：

npm run build

3. 如需调试，可以运行：

npm run inspect 

贡献

1. Fork 该仓库。
2. 创建一个功能分支。
3. 进行更改。
4. 运行测试和代码检查：

npm run typecheck
npm run lint

5. 提交拉取请求。

许可证

MIT