mcpField
🔥
🔥 ALAPI MCP Server

🔥 ALAPI MCP Server

本地服务
github.com/ALAPI-SDK其他1280 周前更新

关于 🔥 ALAPI MCP Server

ALAPI MCP Server 将 ALAPI 的 100 多种接口接入 MCP 客户端,涵盖天气、IP、热榜和企业信息等。它会自动加载 ALAPI OpenAPI 规范,并可加载全部或指定接口。

主要功能

  1. 01接入 100 多种 ALAPI 接口
  2. 02自动加载 OpenAPI 规范
  3. 03选择加载全部或指定接口
  4. 04统一响应格式和错误处理
  5. 05通过环境变量配置访问

适用场景

  1. 01查询 IP 归属地和天气
  2. 02获取热榜与企业信息
  3. 03审核文本或缩短网址
  4. 04查询汇率和快递物流

MCP 相关

该服务通过 Model Context Protocol 将 ALAPI 接口作为工具提供给兼容的 AI 应用。支持远程 SSE 部署,也可在 MCP 客户端中配置本地服务。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"alapi-cn": {
"command": "npx",
"args": [
"-y",
"@smithery/cli"
]
}
}
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

来自项目 README

🔥 ALAPI MCP Server

smithery badge 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

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

☁️ 前往云开发平台部署 MCP Server

方法二:使用 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+个国家和地区货币查询
企业查询根据企业名称或统一社会信用代码查询企业基本工商信息
快递查询免费查询快递物流轨迹,支持中通、申通、顺丰、极兔、百世、圆通等
星座运势提供星座运势查询服务,支持查询十二星座今日或明日、本周、本月、本年的运势
黄金价格查询当前黄金的实时价格,最高价,最低价,品牌黄金的价格

🔗 相关链接

🙏 鸣谢

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。