API市场MCP服务器

API-MARKET MCP服务器

关于

模型上下文协议（MCP）服务器，将API-Market的端点公开为MCP资源。该服务器允许大型语言模型通过MCP协议发现OpenAPI规范定义的API并与之交互。
此存储库提供对以下API的访问： API市场该工具可免费使用，允许代理与所有可用API自由通信，使其功能强大。随着over 200多个API 可在 API市场，您可以利用各种功能。

快速开始

您不需要克隆此存储库即可使用此MCP服务器。您可以在您选择的客户端中简单地配置它。

适用于克劳德桌面

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

对于光标

1. 转到文件->首选项->光标设置。
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市场
2. 转到您的个人资料并选择“我的API密钥”
3. 您的API密钥将显示在此处

此MCP中的API列表

• GET trueway矩阵MatrixService计算驱动矩阵
• 获取magicapi耳语预测--request_id
• POST魔术耳语
• POST capix换脸上传
• POST-capix-faceswap-faceswap-v1-image
• POST-capi-faceswap-faceswap-v1-video
• POST capix换脸结果
• GET trueway地理编码地理编码服务地理编码
• GET trueway地理编码地理编码服务反向地理编码
• 邮政编码
• 获取magicapi编码器预测--request_id
• POST magicapi编码器
• POST-bridgeeml-nsfw检测-nsfw检测
• 获取magicapi whois whois--域名-
• 获取magicapi去模糊器预测--request_id
• POST除雾器
• POST-bridgeeml-text-to-image text_to_image
• 获取magicapi周期预测--request_id
• POST魔法期
• GET trueway places服务查找PlaceByText
• 获取trueway地点地点服务查找地点附近
• 获取magicapi头发预测--request_id
• POST magicapi头发
• 邮政编码
• 获取勇敢的视频搜索
• 获取勇敢的网络搜索
• 获取勇敢的图片搜索
• 获取勇敢的新闻搜索
• 获取勇敢勇敢建议搜索
• 获取勇敢的拼写检查搜索
• POST-magicapi-domain-check_domains
• GET trueway路由方向服务查找DrivingRoute
• GET trueway路由方向服务查找驱动路径
• POST pipfeed解析提取

示例和用法

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

• 分叉回购。
• 创建一个分支。
• 提交拉取请求（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. 修改TypeScript文件 src/.
3. 服务器将自动重建并重新启动。
4. 使用MCP检查器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. 分叉存储库。
2. 创建要素分支。
3. 进行更改。
4. 运行测试和梳理：

npm run typecheck
npm run lint

5. 提交拉取请求。

许可证

麻省理工学院