🔥 ALAPI MCP Server

* !License

这是一个基于 ALAPI 的 MCP (Model Context Protocol) 服务器实现，可以通过MCP协议直接调用ALAPI的接口，轻松将ALAPI丰富的API资源集成到各类支持MCP的AI应用中。

✨ 功能特点

• 🔍 丰富API资源 - 提供IP查询、天气查询、热搜榜单、企业信息等100+种常用API服务
• 🧩 MCP 协议支持 - 完全兼容 Model Context Protocol，轻松集成到各类AI应用
• 🔄 自动加载 - 自动加载 ALAPI OpenAPI 规范，无需手动配置
• 🎯 灵活调用 - 支持加载全部或指定API，按需使用（短视频解析、天气查询、每天60秒读懂世界、企业查询等）
• 🛡️ 统一响应 - 提供统一的错误处理和响应格式，简化开发流程
• ⚙️ 可配置性 - 支持环境变量配置，轻松适应不同使用场景

📖 使用指南

首先需要了解 MCP 协议，然后按照以下配置添加 ALAPI MCP 服务。

在 MCP 客户端中使用

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

方法一： 远程 MCP

本项目支持一键部署到腾讯云开发平台base.net/ai/mcp/develop/host-mcp)，提供远程 SSE 访问

☁️ 前往云开发平台部署 MCP Server.tencent.com/dev#/ai?tab=mcp&p&mcp-template=mcp-alapi-cn)

方法二：使用 Smithery 自动安装

通过 Smithery 安装 ALAPI MCP Server，适用于 Claude Desktop 客户端：

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

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

1. 访问 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，用于接口认证。

MCP 客户端配置示例

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

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

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

支持的 MCP 客户端

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

• Claude Desktop App
• Claude Code
• Cursor
• Continue
• Cline
• 等其他支持 MCP 协议的客户端

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

🛠️ 支持的功能

以下是部分支持的功能，完整功能请以实际调用为准：

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

🔗 相关链接

• ALAPI官网 - 获取API服务和Token
• MCP协议文档 - 了解更多MCP协议相关信息

🙏 鸣谢

• ALAPI - 提供强大的API支持
• Model Context Protocol - 提供协议标准