JinDaGe - mcp-server MCP Details

article

README

🚀 TagoIO | MCP服务器

TagoIO MCP服务器使AI模型能够直接与你的TagoIO账户进行交互，为设备、数据和平台资源提供上下文访问，以优化开发工作流程并实现智能数据分析。

✨ 主要特性

设备管理：访问设备信息、配置和实时数据
数据分析：对存储的数据执行统计操作（求和、求平均值、生成报告）
平台集成：检索用户、操作、分析脚本和账户统计信息
代码生成：借助AI生成具有适当上下文的TagoIO分析脚本
开发支持：提供调试协助和标签关系分析

🚀 快速开始

前提条件

已安装Node.js 18+（下载地址）
拥有有效的TagoIO账户，具备有效的配置文件令牌或分析令牌
兼容的AI平台或集成开发环境（IDE）（见支持的平台）

📦 安装指南

手动配置

创建或更新你的MCP配置文件：

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": ["-y", "@tago-io/mcp-server"],
      "env": {
        "TAGOIO_TOKEN": "YOUR-TOKEN",
        "TAGOIO_API": "https://api.us-e1.tago.io"
      }
    }
  }
}

配置参数：

将 YOUR-TOKEN 替换为你的TagoIO配置文件令牌或分析令牌。
- 为提高安全性，建议使用分析令牌，因为你可以将令牌的权限限制为仅访问所需的资源。你的分析必须设置为“外部”运行，以便使用该令牌。
- 使用配置文件令牌将立即授予MCP访问你整个配置文件的权限，但不建议在生产环境中使用。
对于欧洲账户，请将API端点更新为 https://api.eu-w1.tago.io。

特定平台设置

Claude桌面版

下载并安装Claude桌面版。
复制上述MCP配置。
发送提示信息：“嘿，Claude，安装以下MCP服务器”，并附上配置。
Claude将自动安装并配置服务器。

开发IDE一键安装

或者将配置文件放置在你的IDE的适当位置，然后重新启动应用程序。

| 平台 | 配置路径 | | ------------------ | ------------------------------------- | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | Cline | ~/.cline/mcp_config.json | | Claude Desktop | ~/.claude/mcp_config.json |

📚 详细文档

身份验证

MCP服务器需要一个TagoIO配置文件令牌进行身份验证：

登录到你的TagoIO账户。
导航到账户设置 → 配置文件令牌。
生成一个具有适当权限的新令牌。
在配置中替换 YOUR-PROFILE-TOKEN。

⚠️ 重要提示

请妥善保管你的配置文件令牌，切勿将其提交到版本控制系统。

API端点

服务器支持美国和欧洲的TagoIO实例：

美国东部：https://api.us-e1.tago.io（默认）
欧洲西部：https://api.eu-w1.tago.io

故障排除

常见问题

连接失败
- 检查你的配置文件令牌是否有效。
- 确保你使用的是适合你所在地区的正确API端点。
身份验证错误
- 确认配置文件或分析令牌具有必要的权限。
- 验证配置文件中的令牌格式是否正确。
数据访问问题
- 检查你TagoIO账户中的设备权限。
- 确保设备有最近可用的数据。

📄 许可证

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。

需要帮助？ 访问 TagoIO文档或联系我们的支持团队。

mcp-server