🔥 ALAPI MCP 服务器

基于 ALAPI，MCP（模型上下文协议）服务器实现允许通过MCP协议直接调用ALAPI接口，使丰富的API资源易于集成到支持MCP的各种AI应用中。

✨ 特性

• 🔍 丰富的API资源 - 提供超过100种常用API服务，包括IP查询、天气查询、热门搜索排名、企业信息等
• 🧩 支持MCP协议 - 完全兼容模型上下文协议，易于集成到各种AI应用中
• 🔄 自动加载 - 自动加载ALAPI OpenAPI规范，无需手动配置
• 🎯 灵活调用 - 支持加载所有或指定的API以按需使用（短视频解析、天气查询、每日了解世界60秒、企业查询等）
• 🛡️ 统一响应 - 提供统一的错误处理和响应格式，简化开发过程
• ⚙️ 可配置 - 支持环境变量配置，轻松适应不同的使用场景

📖 用户指南

首先需要理解 MCP 协议，然后根据以下配置添加ALAPI MCP服务。

在MCP客户端中使用

ALAPI MCP服务器设计用于与支持MCP协议的客户端配合使用，并不支持独立的命令行配置。请按照以下步骤在您的MCP客户端中进行配置和使用：

方法1：远程MCP

本项目支持一键部署到腾讯云开发平台提供远程SSE访问

☁️ 在云端开发平台上部署MCP服务器

方法2：使用Smithery进行自动安装

通过 Smithery 安装ALAPI MCP服务器给Claude桌面客户端：

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

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

1. 访问 发布页面 下载最新版本

   国内加速下载地址： 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桌面）中进行配置：

   • 打开MCP客户端设置
   • 添加新的MCP服务器
   • 指定下载的二进制文件路径
   • 配置必要的环境变量（如 ALAPI_TOKEN）

配置环境变量

ALAPI_TOKEN - ALAPI平台访问令牌（必需）

需要配置为您在ALAPI平台上创建的 TOKEN，用于接口认证。

MCP客户端配置示例

在Claude桌面或其他支持MCP的客户端中，您可以参考以下配置：

JSON配置（使用本地二进制文件）

{
  "mcpServers": {
    "alapi": {
      "path": "/path/to/mcp-alapi-cn",
      "env": {
        "ALAPI_TOKEN": "在 ALAPI 平台申请创建的 token"
      }
    }
  }
}

支持的MCP客户端

根据 MCP文档，以下客户端支持MCP工具集成：

• Claude桌面应用
• Claude Code
• Cursor
• Continue
• Cline
• 其他支持MCP协议的客户端

注意：确保您的MCP客户端支持工具集成功能。请参阅每个客户端的具体文档进行配置。

🛠️ 支持的功能

以下是部分支持的功能，请参考实际调用以获取完整功能：

功能名称	描述
IP查询	查询IP归属信息，支持IPv4和IPv6
天气查询	查询国内天气详情，包括天气信息、天气预警、天气指数、AQI等
今日热榜	查询今日热榜数据，包括抖音热榜、头条热榜、知乎、36氪、百度热搜、微博热搜等数据
文本审核	检查文本是否违规，特别适合AI内容审核
短链接	短链接缩短，将长链接缩短为短链接，便于短信发送、二维码生成等场景
二维码识别	支持一张图片多个码，支持十二维码及条形码识别
今天的历史	查询历史上指定日期发生的重大事件
汇率查询	根据货币代码查询货币汇率转换，支持全球170多个国家和地区的货币查询
企业搜索	根据企业名称或统一社会信用代码查询企业的基本信息
快递追踪	免费追踪快递物流，支持中通、申通、顺丰、极兔、百世、圆通等
星座运势	提供星座运势查询服务，支持查询十二星座今日、明日、本周、本月、本年的运势
金价	查看当前金价的实时价格、最高价、最低价及品牌金价

🔗 相关链接

• ALAPI官方网站 - 获取API服务和令牌
• MCP协议文档 - 了解更多关于MCP协议的相关信息

🙏 致谢

• ALAPI - 提供强大的API支持
• 模型上下文协议 - 提供协议标准