Tinybird MCP Server 使用说明

项目简介

Tinybird MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接大型语言模型 (LLM) 客户端与 Tinybird 分析平台。它允许用户通过 LLM 客户端以标准化的方式访问和操作 Tinybird 工作空间中的数据和 API 接口，从而实现更智能的数据分析和应用集成。

主要功能点

数据查询: 使用 Tinybird Query API 查询 Tinybird 数据源，获取实时分析数据。
API 调用: 通过 HTTP 请求调用 Tinybird API Endpoint，获取预先构建的数据分析结果。
数据推送: 支持将本地数据文件 (Datafile) 推送到 Tinybird 工作空间，方便数据导入和管理。
Prompt 模板: 提供默认 Prompt 模板，引导用户探索 Tinybird 数据，并支持自定义 Prompt 模板以适应不同的分析场景。
工具 (Tools): 内置多种工具，例如列出数据源、列出 Pipe Endpoint、查询数据、分析 Pipe 等，方便 LLM 客户端调用和执行。
资源 (Resources): 提供“Insights Memo”资源，用于记录和更新数据分析过程中的关键发现。
支持多种 MCP 客户端: 兼容支持 STDIO 和 SSE 两种传输模式的 MCP 客户端，例如 Claude Desktop 和 Web 应用。

安装步骤

安装 Tinybird MCP Server: 使用 MCP 包管理器 Smithery 或 mcp-get 进行安装。

Smithery:

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

mcp-get:

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

安装 Prerequisites: 确保已安装 Tinybird Account & Workspace、Claude Desktop 和 uv。

服务器配置

配置 Claude Desktop 以连接 Tinybird MCP Server。根据操作系统，创建或编辑 Claude Desktop 配置文件 'claude_desktop_config.json'：

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

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

{
    "mcpServers": {
        "mcp-tinybird": {
            // MCP 服务器名称，在 Claude Desktop 中用于选择集成
            "serverName": "mcp-tinybird",
            // 启动 MCP 服务器的命令，这里使用 uvx 运行 mcp-tinybird 包
            "command": "uvx",
            // 命令参数，指定运行模式为 stdio
            "args": [
                "mcp-tinybird",
                "stdio"
            ],
            // 环境变量配置，用于传递 Tinybird API URL 和 Token
            "env": {
                "TB_API_URL": "<TINYBIRD_API_URL>", // 替换为您的 Tinybird API URL
                "TB_ADMIN_TOKEN": "<TINYBIRD_ADMIN_TOKEN>" // 替换为您的 Tinybird Admin Token
            }
        }
    }
}

基本使用方法

重启 Claude Desktop: 使配置生效。
在 Claude Desktop 中使用 MCP 集成:
- 打开 Claude Desktop 应用。
- 点击附件图标 (通常是纸夹图标)。
- 在附件菜单中，找到 MCP 集成菜单 (图标通常是两个连接的插头)。
- 选择 "Choose an integration" (选择一个集成)。
- 在下拉菜单中，选择 "tinybird-default" Prompt 或其他可用 Prompt。
- 按照 Prompt 的引导，与 LLM 交互，利用 Tinybird MCP Server 提供的工具和资源进行数据分析。
查看 Insights Memo: 在分析过程中，可以使用 "Insights Memo" 资源查看已发现的业务洞察。它会随着分析的进行而实时更新。

通过以上步骤，即可在 Claude Desktop 等 MCP 客户端中使用 Tinybird MCP Server 提供的功能，实现与 Tinybird 工作空间的集成和数据分析。

关键词