内容
# 🔥 ALAPI MCP Server
[](https://smithery.ai/server/@ALAPI-SDK/mcp-alapi-cn)
这是一个基于 [ALAPI](https://www.alapi.cn) 的 MCP (Model Context Protocol) 服务器实现，可以通过MCP协议直接调用ALAPI的接口，轻松将ALAPI丰富的API资源集成到各类支持MCP的AI应用中。
## ✨ 功能特点
- 🔍 **丰富API资源** - 提供IP查询、天气查询、热搜榜单、企业信息等100+种常用API服务
- 🧩 **MCP 协议支持** - 完全兼容 Model Context Protocol，轻松集成到各类AI应用
- 🔄 **自动加载** - 自动加载 ALAPI OpenAPI 规范，无需手动配置
- 🎯 **灵活调用** - 支持加载全部或指定API，按需使用（短视频解析、天气查询、每天60秒读懂世界、企业查询等）
- 🛡️ **统一响应** - 提供统一的错误处理和响应格式，简化开发流程
- ⚙️ **可配置性** - 支持环境变量配置，轻松适应不同使用场景
## 📖 使用指南
首先需要了解 [MCP](https://modelcontextprotocol.io/introduction) 协议，然后按照以下配置添加 ALAPI MCP 服务。
## 在 MCP 客户端中使用
ALAPI MCP Server 设计为与支持 MCP 协议的客户端配合使用，不支持独立的命令行配置。请按照以下步骤在您的 MCP 客户端中配置使用：
### 方法一： 远程 MCP
本项目支持[一键部署到腾讯云开发平台](https://docs.cloudbase.net/ai/mcp/develop/host-mcp)，提供远程 SSE 访问
[☁️ 前往云开发平台部署 MCP Server](https://tcb.cloud.tencent.com/dev#/ai?tab=mcp&p&mcp-template=mcp-alapi-cn)
### 方法二：使用 Smithery 自动安装
通过 [Smithery](https://smithery.ai/server/@ALAPI-SDK/mcp-alapi-cn) 安装 ALAPI MCP Server，适用于 Claude Desktop 客户端：
```bash
npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude
```
### 方法三：直接使用预编译二进制文件（推荐，不用安装依赖）
1. 访问 [Releases 页面](https://github.com/ALAPI-SDK/mcp-alapi-cn/releases) 下载最新版本
> 国内加速下载地址：https://cnb.cool/alapi/mcp-alapi-cn/-/releases
2. 根据您的操作系统选择对应最新的版本：
- Windows: `mcp-alapi-cn.exe`
- macOS: `mcp-alapi-cn-macos`
- Linux: `mcp-alapi-cn-linux`
3. 在支持 MCP 的客户端（如 Claude Desktop）中配置：
- 打开 MCP 客户端设置
- 添加新的 MCP 服务器
- 指定下载的二进制文件路径
- 配置必要的环境变量（如 `ALAPI_TOKEN`）
### 配置环境变量
#### `ALAPI_TOKEN` - ALAPI平台访问令牌（必填）
需要配置为您在 ALAPI 平台上创建的 [TOKEN](https://www.alapi.cn/dashboard/data/token)，用于接口认证。
### MCP 客户端配置示例
在 Claude Desktop 或其他支持 MCP 的客户端中，可以参考以下配置：
#### JSON 配置（使用本地二进制文件）
```json
{
"mcpServers": {
"alapi": {
"path": "/path/to/mcp-alapi-cn",
"env": {
"ALAPI_TOKEN": "在 ALAPI 平台申请创建的 token"
}
}
}
}
```
### 支持的 MCP 客户端
根据 [MCP 文档](https://modelcontextprotocol.io/clients)，以下客户端支持 MCP 工具集成：
- Claude Desktop App
- Claude Code
- Cursor
- Continue
- Cline
- 等其他支持 MCP 协议的客户端
> 注意：确保您的 MCP 客户端支持工具集成功能，请参考各客户端的具体文档进行配置。
## 🛠️ 支持的功能
以下是部分支持的功能，完整功能请以实际调用为准：
| 功能名称 | 描述 |
| ------------ | ----------------------------------------------------------------------------- |
| IP查询 | 查询IP归属地信息，支持IPv4和IPv6 |
| 天气查询 | 查询国内天气详情，包含天气信息、天气预警、天气指数、AQI等 |
| 今日热榜 | 查询今日热榜数据，包含抖音热搜、头条热榜、知乎、36k、百度热搜、微博热搜等数据 |
| 文本审核 | 查询文本是否违规，特别适合AI内容审核 |
| 短网址 | 短网址缩短，将长网址缩短为短网址，方便短信发送、二维码生成等场景 |
| 二维码识别 | 支持一图多码，支持数十二维码，条形码的识别 |
| 历史上的今天 | 查询历史上的指定日期发生的大事 |
| 汇率查询 | 根据货币代码查询货币汇率和换算，支持全球170+个国家和地区货币查询 |
| 企业查询 | 根据企业名称或统一社会信用代码查询企业基本工商信息 |
| 快递查询 | 免费查询快递物流轨迹，支持中通、申通、顺丰、极兔、百世、圆通等 |
| 星座运势 | 提供星座运势查询服务，支持查询十二星座今日或明日、本周、本月、本年的运势 |
| 黄金价格 | 查询当前黄金的实时价格，最高价，最低价，品牌黄金的价格 |
## 🔗 相关链接
- [ALAPI官网](https://www.alapi.cn) - 获取API服务和Token
- [MCP协议文档](https://modelcontextprotocol.io) - 了解更多MCP协议相关信息
## 🙏 鸣谢
- [ALAPI](https://www.alapi.cn) - 提供强大的API支持
- [Model Context Protocol](https://modelcontextprotocol.io) - 提供协议标准
MCP 市场
