🚀 TianAPI MCP 智能工具服务

为 AI Agent 提供 安全、稳定、开箱即用 的真实世界连接能力 —— 无需硬编码 API Key,一键集成主流平台。

什么是 MCP?

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

核心优势:

  • 自动鉴权:API Key 由服务端注入,前端/提示词中永不暴露;
  • 结构化输出:返回字段已清洗、命名规范,LLM 可直接理解;
  • 统一错误处理:网络异常、参数错误、配额超限均有标准响应;
  • 零代码适配:Cherry Studio、Dify、Coze等平台原生支持 MCP 协议;
  • 多工具聚合:可将多个 API 封装为一个 MCP 服务,统一管理、一键调用。
天气预报API接口

MCP vs 传统 API 调用

维度 传统方式 MCP 方式
API Key 管理 需写入提示词或环境变量,易泄露 服务端自动注入,绝对安全
参数传递 需手动拼接 URL 或 JSON 直接传业务参数(如 {"city": "上海"}
也可自然对话(上海今天哪些地方限行?
结果解析 LLM 需理解原始 JSON 结构 返回扁平化字段(如 aqi, quality
平台兼容性 需为每个平台单独开发插件 一次配置,多平台通用
能力组合 单个 API 独立调用,难以协同 可将多个 API 封装为一个 MCP 服务,实现统一调用与流程编排

如何在 Agent 平台中配置 MCP?

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

1. 获取您的专属 MCP 地址

1,访问接口文档如 天气查询 → 点击「MCP 服务」→ 复制服务地址。(单一工具存在一定局限性,非特殊情况不建议)

2,(强烈推荐)在控制台 - 数据管理 - MCP服务中,添加工具集合,随时可以把多个接口注册到同一个MCP服务中,方便AI自动发现和协同。

天气预报API接口

2. 填写 mcpServers 配置(详细过程:如何使用MCP服务?

{
      "mcpServers": {
        "tianapi-tianqi": {
          "url": "https://mcp.tianapi.com/tianqi/{your_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_listtitle, 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服务;在接口管理中停用了接口;调用次数超限余额不足。

相关文章

工单 客服