Tinybird MCP 服务器使用说明

项目简介

Tinybird MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 Tinybird 实时数据分析平台的功能桥接到任何兼容 MCP 的 LLM 客户端（如 Claude）。通过此服务器，LLM 可以安全地访问和利用 Tinybird 工作空间中的数据和分析能力，实现更智能的数据驱动应用。

主要功能点

数据源查询: 使用 SQL 查询 Tinybird 数据源，获取实时数据洞察。
API端点访问: 调用 Tinybird API 端点，获取预先构建的数据分析结果。
数据文件上传: 将本地数据文件上传到 Tinybird 工作空间，方便数据管理和分析。
内置 Prompt 模板: 提供预定义的 Prompt 模板，引导用户探索和分析 Tinybird 数据。
丰富的工具集: 提供一系列工具，包括数据源和 Pipe 端点列表、数据源和 Pipe 端点详情获取、SQL 查询执行、业务洞察记录、Tinybird 文档访问等，方便 LLM 与 Tinybird 工作空间进行深度交互。

安装步骤

使用 MCP 包管理器 (推荐)：

Smithery: 如果您的 LLM 客户端支持 Smithery，可以使用以下命令自动安装 Tinybird MCP 服务器：

npx @smithery/cli install mcp-tinybird --client claude

mcp-get: 如果您的 LLM 客户端支持 mcp-get，可以使用以下命令安装：

npx @michaellatman/mcp-get@latest install mcp-tinybird

手动安装 (Prerequisites)：
- 确保您已安装 Tinybird 账号 & 工作空间、Claude Desktop 和 uv。

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是 Claude Desktop 客户端的配置示例，您需要根据您的 MCP 客户端类型进行相应配置。

Claude Desktop 配置 (claude_desktop_config.json)

根据您的操作系统，创建或编辑配置文件：

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

将以下 JSON 模板粘贴到配置文件中，并替换 '<YOUR_TINYBIRD_API_URL>' 和 '<YOUR_TINYBIRD_ADMIN_TOKEN>' 为您的 Tinybird API URL 和管理员 Token。

{
    "mcpServers": {
        "mcp-tinybird": {  // MCP 服务器名称，您可以自定义
            "command": "uvx", // 运行 MCP 服务器的命令，uvx 用于执行已安装的 Python 包
            "args": [
                "mcp-tinybird" // 命令参数，指定要运行的 Python 包为 mcp-tinybird
            ],
            "env": { // 环境变量配置
                "TB_API_URL": "<YOUR_TINYBIRD_API_URL>", // 您的 Tinybird API URL
                "TB_ADMIN_TOKEN": "<YOUR_TINYBIRD_ADMIN_TOKEN>" // 您的 Tinybird 管理员 Token
            }
        }
    }
}

配置说明:

'"mcp-tinybird"': MCP 服务器的名称，在客户端中用于识别和选择该服务器。您可以自定义名称。
'"command": "uvx"': 指定执行 MCP 服务器的命令。'uvx' 是一个用于执行已安装 Python 包的工具，通常用于 MCP 服务器的部署和运行。
'"args": ["mcp-tinybird"]': 命令的参数，这里指定要运行的 Python 包名称为 'mcp-tinybird'，即 Tinybird MCP 服务器的 Python 包名。
'"env"': 环境变量配置，用于传递服务器运行所需的配置信息。
- '"TB_API_URL"': Tinybird API 的 URL，请替换为您的 Tinybird 工作空间的 API 地址。
- '"TB_ADMIN_TOKEN"': Tinybird 管理员 Token，用于服务器认证和授权访问您的 Tinybird 工作空间。请替换为您的 Tinybird 管理员 Token。

完成配置后，重启您的 MCP 客户端 (如 Claude Desktop) 使配置生效。

基本使用方法

确保已完成安装和配置，并已重启 MCP 客户端。
在您的 MCP 客户端中，打开 MCP 功能菜单（通常通过纸夹图标访问）。
选择 "Choose an integration" (选择集成) 或类似选项。
在下拉菜单中，您应该能看到 "mcp-tinybird" 或您配置的服务器名称。选择它。
您可以选择预定义的 Prompt 模板（如 "tinybird-default"），或者使用提供的工具集与 Tinybird 工作空间进行交互。
根据 Prompt 的引导或您的需求，使用工具执行数据查询、API 调用等操作，获取 Tinybird 数据的洞察。

详细使用方法请参考仓库 README 文档和示例链接。

关键词