Tinybird MCP server

Tinybird MCP server

未知

GitHub
Created Bytinybirdcotinybirdco

简介

Tinybird MCP 服务器允许你通过 MCP（Model Context Protocol）客户端（如 Claude Desktop）与 Tinybird 数据平台交互，执行数据查询、分析和推送操作。

Tinybird 服务器 MCP 服务器

安装

使用 Smithery 或 mcp-get 安装:

# 通过 Smithery 安装
npx @smithery/cli install @tinybirdco/mcp-tinybird --client claude

# 或通过 mcp-get 安装
npx @michaellatman/mcp-get@latest install mcp-tinybird

配置

  1. 创建 Claude Desktop 配置文件:

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

  2. 添加以下配置（替换 Tinybird 凭据）:

{
    "mcpServers": {
        "mcp-tinybird": {
            "command": "uvx",
            "args": [
                "mcp-tinybird",
                "stdio"
            ],
            "env": {
                "TB_API_URL": "<TINYBIRD_API_URL>",
                "TB_ADMIN_TOKEN": "<TINYBIRD_ADMIN_TOKEN>"
            }
        }
    }
}
  1. 重启 Claude Desktop

核心功能

  • 查询 Tinybird 数据源
  • 获取 API 端点的结果
  • 推送数据文件
  • 分析管道性能

使用工具

服务器提供多个工具与 Tinybird 交互:

  • list-data-sources: 列出所有数据源
  • run-select-query: 对数据源执行 SQL 查询
  • request-pipe-data: 从管道端点请求数据
  • push-datafile: 上传数据文件创建数据源

运行模式

  • STDIO 模式 (默认): 与 Claude Desktop 集成
  • SSE 模式: 用于 Web 应用和其他支持 SSE 的客户端
uvx mcp-tinybird sse

调试

使用 MCP Inspector 调试:

npx @modelcontextprotocol/inspector uv run mcp-tinybird

提示工作流

服务器包含内置的 tinybird-default 提示，需要一个 "topic" 参数来定义探索的数据主题。

你可以向提示数据源添加自定义提示，服务器在初始化时会加载它们。

了解更多