🚀 TianAPI MCP 智能工具服务

什么是 MCP？

TianAPI MCP（Model Calling Protocol） 是天聚数行基于标准 MCP 协议实现的工具调用服务。我们将复杂的API调用过程封装为语义清晰、参数规范的“工具函数”，使大语言模型（LLM）驱动的智能体能够在推理过程中安全、可靠地调用服务。开发者或普通用户无需编程即可轻松实现在支持MCP协议的AI客户端（如 GitHub Copilot、Cherry Studio 等）中直接调用接口，实现智能上下文感知数据查询。

核心优势：

✅ 自动鉴权：API Key 由服务端注入，前端/提示词中永不暴露；
✅ 结构化输出：返回字段已清洗、命名规范，LLM 可直接理解；
✅ 统一错误处理：网络异常、参数错误、配额超限均有标准响应；
✅ 零代码适配：Cherry Studio、Dify、Coze等平台原生支持 MCP 协议。

MCP vs 传统 API 调用

维度	传统方式	MCP 方式
API Key 管理	需写入提示词或环境变量，易泄露	服务端自动注入，绝对安全
参数传递	需手动拼接 URL 或 JSON	直接传业务参数（如 `{"city": "上海"}`）也可自然对话（`上海今天哪些地方限行？`）
结果解析	LLM 需理解原始 JSON 结构	返回扁平化字段（如 `aqi`, `quality`）
平台兼容性	需为每个平台单独开发插件	一次配置，多平台通用

如何在 Agent 平台中配置 MCP？

所有支持 MCP 协议的平台（如 Cherry Studio、Dify、Coze、百炼）均使用相同的 mcpServers 配置格式：

1. 获取您的专属 MCP 地址

访问接口文档如天气查询 → 点击「MCP 服务」→ 复制服务地址。

2. 填写 mcpServers 配置（详细过程：如何使用MCP服务？）

{
  "mcpServers": {
    "tianapi-tianqi": {
      "url": "https://mcp.tianapi.com/tianqi/您的APIKEY"
    }
  }
}

3. 各平台配置位置参考

Dify

创建应用 → 工具 → “MCP 工具” → 粘贴上述 JSON

Coze / 扣子

Bot 设置 → 插件 → “自定义 MCP” → 输入配置

百炼

工作流 → 工具节点 → 选择 “MCP 服务” → 填入配置

部分 MCP 推荐

以下接口已全面支持 MCP 协议，覆盖生活、出行、健康、社交等高频场景：

🌤️ 实时天气（`tianqi`）

查询全国城市未来7天天气、温度、湿度、风力、空气质量建议。

调用示例： {"city": "深圳"}

返回字段： city, temp, humidity, wind

📦 快递查询（`kuaidi`）

自动识别快递公司，实时追踪物流轨迹（支持顺丰、中通、京东等）。

调用示例： {"number": "YT123456789CN"}

返回字段： com, status, list

🚗 车辆限行（`vehiclelimit`）

获取北京、杭州、成都等城市今日/明日尾号限行规则及区域图。

调用示例： {"city": "成都"}

返回字段： date, limit_info, area

🔥 热搜榜单（`networkhot`）

获取百度、微博、抖音实时热搜榜，含热度值与跳转链接。

调用示例： {"type": "weibo"}

返回字段： hot_list（title, hot）

⛽ 全国油价（`oilprice`）

返回92#、95#、98#汽油及0#柴油最新零售价（按省份）。

调用示例： {prov}

返回字段： province, p92, p95

🥗 菜品热量（`imgcaipin`）

识别餐食图片中的菜品，返回热量（kcal）、蛋白质、脂肪等营养信息。

调用示例： {"imgurl": "https://meal.jpg"}

返回字段： name, calorie, trust

更多支持MCP服务的接口，可在接口文档顶部查看是否标有MCP标签。

常见问题（FAQ）

Q：MCP 是否收费？

A：MCP 本身免费，但所调用的接口按 TianAPI 标准计费（免费接口100次/天，计费接口都有测试额度）。

Q：能否在一个 mcpServers 中配置多个接口？

A：可以！如上文示例所示，一个 JSON 可包含数十个工具，平台会自动加载。

Q：图片类接口（如菜品热量）如何传图？

A：直接传图或将图片上传至公网可访问 URL（如 OSS、图床），再将imgurl 传入。

Q：如何调试 MCP 调用是否成功？

A：可在控制台查看「API 调用日志」，包含请求参数、响应内容、状态码。

Q：配置MCP出现报错或查询失败为什么？

A：可能该接口暂未支持MCP服务；在接口管理中停用了接口；调用次数超限余额不足。