API-MARKET MCP 服务器

关于

一个模型上下文协议 (MCP) 服务器，将 API-Market 的端点作为 MCP 资源公开。该服务器允许大型语言模型通过 MCP 协议发现和交互由 OpenAPI 规范定义的 API。
此存储库提供了访问 API.market 上可用的 API。该工具免费使用，并允许代理与所有可用的 API 自由通信，功能非常强大。在 API.market 上有超过 200+ 个 API 可供选择，您可以利用广泛的功能。

快速开始

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

对于 Claude Desktop

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

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

对于 Cursor

1. 转到 文件 -> 首选项 -> Cursor 设置。
2. 选择 MCP。
3. 点击添加新的全局 MCP 服务器。
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，在点击添加新 MCP 服务器后添加以下命令：

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

从 API.market 获取 API 密钥

要获取 API 密钥：

1. 登录到 API.market
2. 转到您的个人资料并选择 '我的 API 密钥'
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

我们可以使用代理在任意两点之间找到路线

示例 2

我们可以使用代理查找任何主题的新闻，并深入研究文章

示例 3

我们可以使用代理查找可用域名

开发

向 MCP 服务器添加新 API

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

1. 定位 OpenAPI 规范

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

2. 修改 OpenAPI 规范

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

python utils/modify_api.py

3. 更新 API 摘要

修改路径后，通过选择以下选项之一更新 API 摘要：

• 使用 LLM 自动缩短摘要：

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. 运行测试和 Linting：

npm run typecheck
npm run lint

5. 提交拉取请求。

许可证

MIT