使用说明

项目简介

API200 MCP 服务器是 API-200 开源 API 集成平台的一部分，它实现了 Model Context Protocol (MCP) 协议，可以将 API200 平台中集成的各种第三方 API 转化为标准化的 工具 (Tools)，供支持 MCP 协议的 LLM 客户端（如 Claude Desktop）调用。通过 API200 MCP 服务器，LLM 应用可以安全、便捷地访问和利用丰富的外部 API 数据和功能。

主要功能点

MCP 协议支持: 完全实现了 MCP 协议服务器端规范，可以处理来自 LLM 客户端的 MCP 请求并返回符合协议的响应。
API 工具动态注册: 能够动态地将 API-200 平台中已集成的第三方 API 自动注册为 MCP 工具 (Tools)，无需手动配置。
Stdio 传输协议: 支持 Stdio 传输协议，方便与本地 LLM 客户端进行集成和通信。
基于 API-200 平台: 依赖于 API-200 平台的用户认证和 API 管理能力，提供安全可靠的 API 访问控制。
易于部署: 提供 Docker Compose 部署方式，方便用户快速搭建自托管的 MCP 服务器。

安装步骤

环境准备: 确保已安装 Docker 和 Docker Compose，以及 Node.js 和 npm。

克隆仓库: 克隆 API-200 自托管仓库 api200-selfhosted 到本地。

git clone https://github.com/API-200/api200-selfhosted
cd api200-selfhosted

安装依赖: 在 'api200-selfhosted' 目录下运行 npm 命令安装项目依赖。
```
npm install
```
运行安装脚本: 根据您的部署环境（本地或非本地）选择相应的命令运行安装脚本，该脚本将生成必要的配置文件。
- 本地环境（localhost，推荐管理员权限）：
```
sudo node setup.js
```
- 非本地环境：
```
node setup.js
```
注意: 本地环境安装需要修改 hosts 文件，可能需要管理员权限。
启动服务: 使用 Docker Compose 启动 API-200 平台的所有服务，包括 MCP 服务器。
```
docker-compose up -d
```

服务器配置

API200 MCP 服务器通过标准 Stdio 协议与 MCP 客户端通信。以下是配置 Claude Desktop 等 MCP 客户端连接 API200 MCP 服务器的 JSON 配置信息：

{
  "mcpServers": {
    "api200": {
      "command": "npx",
      "args": [
        "api200-mcp@latest"
      ],
      "env": {
        "USER_KEY": "your-api-key-here"
      }
    }
  }
}

配置参数说明:

'"mcpServers"': 定义 MCP 服务器配置的根节点。
'"api200"': 自定义的服务器名称，可以根据需要修改。
'"command"': 启动 MCP 服务器的命令，这里使用 'npx' 来运行 'api200-mcp' 包。
'"args"': 传递给启动命令的参数，'api200-mcp@latest' 表示运行最新版本的 'api200-mcp' 包。
'"env"': 环境变量配置。
- '"USER_KEY"': [重要] API200 平台的用户 API 密钥。您需要在 API200 平台获取您的 API 密钥并替换 '"your-api-key-here"'。该密钥用于 MCP 服务器向 API200 后端验证用户身份和获取可用的 API 服务列表。

基本使用方法

获取 API 密钥: 登录您的 API200 平台账号，在控制台或设置页面找到并复制您的 API 密钥（USER_KEY）。
配置 MCP 客户端: 打开您的 MCP 客户端（例如 Claude Desktop）的开发者设置，添加自定义工具，并将上述 JSON 配置信息填入，务必将 '"your-api-key-here"' 替换为您在 API200 平台获取的 API 密钥。
连接 MCP 服务器: 在 MCP 客户端中启用您配置的 API200 MCP 服务器。
使用 API 工具: 连接成功后，API200 平台集成的 API 将作为 工具 (Tools) 注册到 MCP 客户端。您可以在 LLM 应用中通过调用这些工具来访问相应的 API 功能。工具名称通常会以 'method_endpoint_name' 的形式呈现，例如 'get_users_list'。

访问 API200 平台

前端界面: 'http://<your-hostname-or-ip>:3000'
API 处理服务: 'http://<your-hostname-or-ip>:8080'

请将 '<your-hostname-or-ip>' 替换为您部署 API-200 平台的主机名或 IP 地址。

关键词

使用说明

信息