天聚数行 MCP 服务配置指南

部署运行你感兴趣的模型镜像

天聚数行(TianAPI)已逐步适配开放提供 MCP(Model Context Protocol) 支持,我们将复杂的 API 调用过程封装为语义清晰、参数规范的“工具函数”,使大语言模型(LLM)驱动的智能体能够在推理过程中安全、可靠地调用服务。开发者或普通用户无需编程即可轻松实现在支持MCP协议的AI 客户端(如 GitHub Copilot、Cherry Studio 等)中直接调用 API接口,实现智能上下文感知数据查询。为帮助您在支持 MCP 的 AI 环境中快速接入我们的数据服务,本文将举例介绍如何在 Cherry Studio 和 GitHub Copilot 中完成MCP配置。

 前提准备

注册并登录天聚数行账号,进入控制台→ 数据管理→我的API 密钥,复制您的专属 PIKEY。

确认您已申请并启用某个支持MCP服务的接口,下文以「天气预报」举例。

 哪些接口支持MCP服务?

在接口文档顶部有标有MCP的接口已完成开放适配,可以直接使用。提示:新闻类接口请统一使用“分类新闻”这个接口的MCP服务。

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

   

天气预报API接口

MCP 服务配置信息

天聚数行提供的 MCP 服务采用动态 URL 模板,xxx为工具名(例如tianqi),您需将 {APIKEY} 替换为您自己的密钥:

{
  "mcpServers": {
      "tianapi-xxx": {
            "url": "https://mcp.tianapi.com/xxx/{APIKEY}"    
              }  
         }
}

该端点已内置认证逻辑,无需额外设置 Bearer Token 或 Headers,只需在 URL 中包含有效 APIKEY 即可调用。

 在 Cherry Studio 中配置

Cherry Studio 原生支持 MCP 服务注册。请按以下步骤操作:

 1,打开设置

启动 Cherry Studio,点击左下角 ⚙️ Settings → 进入 AI Assistants → 选择 MCP Servers。

 在 Cherry Studio 中配置

2,添加 MCP 服务

点击 + Add Server,填写如下信息:

Server Name: tianapi-tianqi(建议与配置键一致)

Server URL: https://mcp.tianapi.com/tianqi/您的APIKEY

(提示:请确保将 您的APIKEY 替换为实际密钥,例如:https://mcp.tianapi.com/tianqi/abcde12345678)

 3,保存并启用

点击 Save,Cherry Studio 将自动加载服务元数据。

Cherry Studio 将自动加载服务元数据

随后,您可在聊天或代码辅助中直接使用自然语言请求天气数据,例如:

“查询上海未来三天的天气情况”

系统将通过 MCP 自动调用天聚数行服务并返回结构化结果。

_20251107190306_5_1007.png

在 GitHub Copilot 中配置

目前 GitHub Copilot 对第三方 MCP 服务的支持依赖于 IDE 插件生态(如 VS Code 的 Copilot Labs 或自定义 MCP 扩展)。若您使用的环境支持 MCP 配置,请按以下方式操作:

在 GitHub Copilot 中配置

1,确认 IDE 支持 MCP

请确保您已安装支持 MCP 协议的扩展(例如:Copilot for CLI、MCP Client for VS Code 等)。

2,配置 MCP 服务

在插件设置中添加如下配置项(以 天气查询“tianqi ”为例):

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

3,使用服务

配置生效后,在 Copilot 聊天窗口或代码注释中输入:获取上海当前温度和天气状况

Copilot 将通过天聚数行 MCP 服务获取实时数据,并生成适合人类阅读的回答。

4,注意事项

请务必保管好接口密钥apikey,如果泄漏请控制台 - 数据管理 - 重置KEY。

按照最小权限规则,不用的接口请及时在控制台 - 数据管理中关闭。

AI工具在回答普遍问题时,可能会选择性调用接口数据,请及时关注接口计费情况。

MCP服务是代理模式调用的,因此接口请求来源是内部IP无法溯源,因此请严格保管接口密钥。

请注意:请不要把配置信息或者配置信息中的URL字段复制发送给第三方,否则会泄漏接口密钥。

5,常见问题解答

Q1:调用返回 “Invalid APIKEY” 或 403 错误?

请检查:

APIKEY 是否正确复制(无多余空格);

是否已在天聚数行控制台 开通天气预报接口(ID: 72);

接口已停用或调用次数超限(控制台 - 数据管理)。

Q3:MCP 调用是否计费?

MCP服务本身免费,但每次 MCP 请求等同于一次标准 API 调用,按接口自身的规则计费(都有免费配额)。

您可能感兴趣的与本文相关的镜像

Qwen3-VL-30B

Qwen3-VL-30B

图文对话
Qwen3-VL

Qwen3-VL是迄今为止 Qwen 系列中最强大的视觉-语言模型,这一代在各个方面都进行了全面升级:更优秀的文本理解和生成、更深入的视觉感知和推理、扩展的上下文长度、增强的空间和视频动态理解能力,以及更强的代理交互能力

已经博主授权,源码转载自 https://pan.quark.cn/s/a4b39357ea24 QueueForMcu 基于单片机实现的队列功能模块,主要用于8位、16位、32位非运行RTOS的单片机应用,兼容大多数单片机平台。 开源代码:https://.com/xiaoxinpro/QueueForMcu 一、特性 动态创建队列对象 动态设置队列数据缓冲区 静态指定队列元素数据长度 采用值传递的方式保存队列数据 二、快速使用 三、配置说明 目前QueueForMcu只有一个静态配置项,具体如下: 在文件 中有一个宏定义 用于指定队列元素的数据长度,默认是 ,可以根据需要更改为其他数据类型。 四、数据结构 队列的数据结构为 用于保存队列的状态,源码如下: 其中 为配置项中自定义的数据类型。 五、创建队列 1、创建队列缓存 由于我们采用值传递的方式保存队列数据,因此我们在创建队列前要手动创建一个队列缓存区,用于存放队列数据。 以上代码即创建一个大小为 的队列缓存区。 2、创建队列结构 接下来使用 创建队列结构,用于保存队列的状态: 3、初始化队列 准备好队列缓存和队列结构后调用 函数来创建队列,该函数原型如下: 参数说明: 参考代码: 六、压入队列 1、单数据压入 将数据压入队列尾部使用 函数,该函数原型如下: 参数说明: 返回值说明: 该函数会返回一个 枚举数据类型,返回值会根据队列状态返回以下几个值: 参考代码: 2、多数据压入 若需要将多个数据(数组)压入队列可以使用 函数,原理上循环调用 函数来实现的,函数原型如下: 参数说明: 当数组长度大于队列剩余长度时,数组多余的数据将被忽略。 返回值说明: 该函数将返回实际被压入到队列中的数据长度。 当队列中的剩余长度富余...
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值