API-Market MCP Server

MIT License
111
2
  • Apple

Integrations

  • Enables searching for videos, web content, images, news, and access to suggest and spellcheck functionality through Brave's search services

  • Provides access to code generation capabilities through the MagicAPI Coder service, allowing creation and retrieval of code predictions

  • Allows calculation of driving matrices including distances and travel times between multiple locations using Trueway's Matrix service

API-MARKET MCP 服务器

关于

一个模型上下文协议 (MCP) 服务器,它将 API 市场的端点公开为 MCP 资源。该服务器允许大型语言模型通过 MCP 协议发现并交互 OpenAPI 规范定义的 API。
此存储库提供对API.market上可用 API 的访问。该工具免费使用,并允许代理与所有可用 API 自由通信,功能极其强大。API.market提供200 多个 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>" ] },
  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

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

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

  • 分叉 repo。
  • 创建分支。
  • 提交拉取请求 (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. 运行测试和 linting:
npm run typecheck npm run lint
  1. 提交拉取请求。

执照

麻省理工学院

-
security - not tested
A
license - permissive license
-
quality - not tested

模型上下文协议服务器将来自 API.market 的 200 多个 API 作为 MCP 资源公开,允许大型语言模型通过自然语言命令发现各种 API 并与之交互。

  1. About
    1. Quick Start
      1. For Claude Desktop
      2. For Cursor
    2. Getting an API Key from API.market
      1. List of APIs in this MCP
        1. Example and Usage
          1. Example 1
          2. Example 2
          3. Example 3
        2. Development
          1. Adding a New API to the MCP Server
        3. Development Tools
          1. Building
          2. Development Mode
          3. Code Quality
          4. Development Workflow
          5. Debugging or Running Locally
          6. Contributing
          7. License
        ID: 1gffc169l7