使用说明

项目简介

ALAPI MCP Server 是一个基于 ALAPI 开放API平台构建的 MCP (Model Context Protocol) 服务器。它将 ALAPI 平台提供的丰富 API 服务转换为符合 MCP 协议的工具，使得各类支持 MCP 协议的 AI 客户端（如 Claude Desktop、Cursor 等）能够轻松调用 ALAPI 提供的各种实用 API，扩展 AI 应用的功能边界。

主要功能点

丰富的API资源: 集成 ALAPI 平台超过 100 种常用 API 服务，涵盖生活常用、信息查询、文娱等多个领域，例如：IP 查询、天气查询、热搜榜单、企业信息、文本审核、短网址生成、二维码识别、汇率查询、快递查询、星座运势等。
标准MCP协议支持: 完全遵循 Model Context Protocol 协议标准，确保与所有兼容 MCP 协议的 AI 客户端无缝集成。
自动加载API: 自动加载 ALAPI 提供的 OpenAPI 规范，无需手动配置 API 接口信息，简化部署和使用流程。
灵活部署方式: 提供多种部署方式，包括一键远程部署到云平台、Smithery 自动安装以及直接使用预编译二进制文件，满足不同用户的需求。
统一响应处理: 所有 API 调用返回统一的 JSON 响应格式，方便客户端解析和处理。

安装步骤

根据您的使用场景选择以下安装方式之一：

方法一：远程 MCP - 一键部署到腾讯云开发平台 (SSE 访问)

点击前往云开发平台部署 MCP Server 链接，按照指引完成一键部署。
部署完成后，您将获得一个远程 SSE 访问地址，可以在支持远程 MCP 的客户端中使用。

方法二：使用 Smithery 自动安装 (适用于 Claude Desktop 客户端)

确保您已安装 Smithery CLI。

在终端中运行命令：

npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude

按照 Smithery 的提示完成安装。

方法三：直接使用预编译二进制文件 (推荐，无需安装依赖)

访问 Releases 页面下载最新版本。国内加速下载地址：https://cnb.cool/alapi/mcp-alapi-cn/-/releases
根据您的操作系统（Windows, macOS, Linux）选择对应的二进制文件下载。
将下载的二进制文件保存到本地目录。

服务器配置 (MCP 客户端配置)

在支持 MCP 协议的客户端中（例如 Claude Desktop），您需要配置 MCP 服务器连接信息。以下是使用本地二进制文件方式的 JSON 配置示例：

{
  "serverName": "alapi",
  "command": "/path/to/mcp-alapi-cn",
  "args": [],
  "env": {
    "ALAPI_TOKEN": "your_alapi_token"
  }
}

配置参数说明：

'serverName': 自定义的 MCP 服务器名称，用于在客户端中标识。例如 "alapi"。
'command': MCP 服务器可执行文件的路径。请将 '/path/to/mcp-alapi-cn' 替换为您实际下载或部署的 'mcp-alapi-cn' 二进制文件的完整路径。
'args': 启动参数，本服务器无需额外启动参数，保持为空数组 '[]' 即可。
'env': 环境变量配置。
- 'ALAPI_TOKEN': ALAPI 平台访问令牌 (Token)，必填。请前往 ALAPI 官网注册并创建应用，然后在 Token 管理页面获取您的 API Token，并替换 'your_alapi_token'。

请注意：

如果您选择方法一：远程 MCP 部署，则无需配置 'command' 和 'args'，而是需要在客户端中配置远程 SSE 服务器地址。具体配置方法请参考您的 MCP 客户端文档。
'ALAPI_TOKEN' 是必填的环境变量，用于 API 鉴权，请务必正确配置。

基本使用方法

确保您的 MCP 客户端已正确配置并连接到 ALAPI MCP Server。
在客户端的工具调用界面，您应该能够看到 ALAPI MCP Server 提供的各种 API 工具，工具名称通常对应 API 的路径 (例如 '/api/ip' 为 IP 查询工具)。
根据工具的参数描述，填写必要的参数信息。
客户端会将您的请求通过 MCP 协议发送到 ALAPI MCP Server。
ALAPI MCP Server 调用相应的 ALAPI API 并将结果返回给客户端。
您可以在客户端中查看 API 调用的结果。

具体可用的 API 工具列表请参考支持的功能或访问 ALAPI 官网了解更多 API 服务。

关键词