Tinybird

🚀 小型鳥 MCP 服務器

小型鳥 MCP 服務器是一款用於數據分析和數據管道管理的工具，支持通過命令行界面與 Tinybird 平臺進行交互。本文檔將詳細介紹其功能、安裝步驟、配置方法以及使用示例。

🚀 快速開始

Tinybird MCP 服務器可助力用戶進行數據分析和數據管道管理，通過命令行界面與 Tinybird 平臺交互。下面將詳細介紹其安裝、配置等操作。

✨ 主要特性

核心功能

• 數據源管理：可列出和查看工作區中的數據源。
• 管道管理：能夠列出和查看工作區中的管道端點及其 SQL 轉換邏輯。
• 數據請求：通過 HTTP 請求獲取管道端點的數據，且支持參數過濾。
• 查詢執行：可直接在數據源上運行 SELECT 查詢以提取洞察。
• 文檔訪問：內置 Tinybird 產品文檔，供 LLM 使用上下文信息。
• 事件記錄：能將用戶生成的提示保存到指定數據源。
• 性能分析：使用 Tinybird 分析 API 提供索引、排序鍵和分區鍵的優化建議。

擴展功能

• 數據文件推送：結合 Filesystem MCP，可從本地數據文件創建遠程數據源或管道。

📦 安裝指南

方法一：使用 uvx

uvx install mcp-tinybird

方法二：手動安裝

1. 克隆倉庫：

   git clone https://github.com/modelcontextprotocol/servers.git
   cd servers/tinybird
   

2. 安裝依賴並構建：

   uv sync && uv build
   

🔧 配置

在根目錄下創建一個 .env 文件，添加以下內容：

TB_API_URL=
TB_ADMIN_TOKEN=

更新 Claude Desktop 配置：

{
  "mcpServers": {
    "mcp-tinybird_local": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/mcp-tinybird",
        "run",
        "mcp-tinybird",
        "stdio"
      ]
    }
  }
}

💻 使用示例

基礎用法

1. 列出工作區中的數據源：

   mcp-tinybird list data-sources
   

2. 獲取特定數據源的詳細信息：

   mcp-tinybird get data-source "your_data_source_name"
   

高級用法

1. 請求管道端點的數據：

   # 通過指定參數過濾數據
   mcp-tinybird request pipe "your_pipe_name" --params "param1=value1&param2=value2"
   

2. 執行自定義查詢：

   # 執行自定義的 SELECT 查詢
   mcp-tinybird run-select-query "SELECT column1, COUNT(*) FROM your_table GROUP BY column1"
   

3. 分析管道端點的性能：

   # 分析指定管道端點的性能
   mcp-tinybird analyze pipe "your_pipe_name"
   

📚 詳細文檔

開發指南

項目結構

mcp-tinybird/
├── src/
│   ├── main.py          # 主程序入口
│   ├── commands/       # 各功能命令的實現模塊
│   └── resources/      # 資源文件，如文檔等
└── README.md           # 項目說明文檔

運行與調試

1. 開發環境啟動：

   uv run mcp-tinybird stdio
   

2. 使用 MCP 檢查器進行調試：

   npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-tinybird run mcp-tinybird
   

打包與發佈

1. 同步依賴並構建：

   uv sync && uv build
   

2. 發佈到 PyPI：

   uv publish --token your_pypi_token
   

監控與優化

為了監控 MCP 服務器，可以集成 Prometheus 和 Grafana。具體方法請參考 監控指南。

更多詳細信息，請訪問 Tinybird 官方文檔 或聯繫技術支持。