API市场MCP服务器

@Noveum/api-market-mcp-server
0 Stars 76 次浏览 Noveum 更新于 2026-08-23

一种模型上下文协议（MCP）服务器，它将API.market上的200多个API作为MCP资源进行暴露，允许大型语言模型通过自然语言命令发现并交互各种API。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

API-MARKET MCP 服务器

关于

这是一个模型上下文协议（MCP）服务器，它将 API-Market 的端点作为 MCP 资源暴露出来。此服务器允许大型语言模型通过 MCP 协议发现和与由 OpenAPI 规范定义的 API 进行交互。
该仓库提供了访问 API.market 上可用 API 的途径。该工具是免费使用的，并且允许代理自由地与所有可用 API 通信，使其非常强大。在 API.market 上有超过 200+ API 可供使用，您可以利用广泛的功能。

快速开始

您不需要克隆此仓库即可使用此 MCP 服务器。您可以简单地在所选客户端中进行配置。

对于 Claude 桌面版

  1. 找到或创建您的 Claude 桌面配置文件：
    • 在 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. 前往 文件 -> 首选项 -> 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>"
      ]
    },
  1. 对于旧版本的 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 列表

示例和用法

示例 1

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

示例 1

示例 2

我们可以使用代理来查找关于任何主题的新闻，然后深入研究这些文章。

示例 2.1
示例 2.2

示例 3

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

示例 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 贡献给仓库：

  • 分叉仓库。
  • 创建一个分支。
  • 提交一个拉取请求 (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
  1. 修改 src/ 中的 TypeScript 文件。
  2. 服务器将自动重新构建并重启。
  3. 使用 MCP Inspector UI 测试您的更改。

调试或本地运行

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

  1. 克隆仓库并安装依赖项：
git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install
  1. 构建服务器：
npm run build
  1. 对于调试，您可以运行：
npm run inspect

贡献

  1. 分叉仓库。
  2. 创建一个功能分支。
  3. 进行您的更改。
  4. 运行测试和代码检查：
npm run typecheck
npm run lint
  1. 提交一个拉取请求。

许可证

MIT

查看源码 项目主页