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 服务器：

   {
     "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

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

示例 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 类型。

<!-- ##### 设置环境变量： 通过运行以下命令配置您的环境：

export OPENAPI_SPEC_PATH=modified_files.txt # optional
export API_BASE_URL=https://api.magicapi.dev/api/v1/ # optional
export API_HEADERS="x-magicapi-key:your-api-key"
``` -->

#### 命令行参数
```bash
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