Skip to main content
Glama
Sign In
enesjakozh

Tinybird MCP server

Official
by tinybirdco
GitHub
Python
Apache 2.0
51
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Tinybird MCP サーバー

任意の MCP クライアントから Tinybird Workspace と対話するための MCP サーバー。

特徴

  • Tinybird クエリ API を使用して Tinybird データ ソースをクエリする
  • HTTPリクエストで既存のTinybird APIエンドポイントの結果を取得する
  • データファイルのプッシュ

SSE モードと STDIO モードの両方をサポートします。

使用例

設定

インストール

MCP パッケージマネージャーの使用

鍛冶屋

Smithery経由で Claude Desktop 用の Tinybird MCP を自動的にインストールするには:

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

mcp-get

mcp-getを使用して Tinybird MCP サーバーをインストールできます。

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

前提条件

MCP はまだ非常に新しく、進化を続けています。MCP の基本を理解して実行するには、 MCP ドキュメントに従うことをお勧めします。

必要なもの:

構成

1. Claudeデスクトップを設定する

OSに応じて次のファイルを作成します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

このテンプレートをファイルに貼り付け、 <TINYBIRD_API_URL>と<TINYBIRD_ADMIN_TOKEN>を Tinybird API URL と管理者トークンに置き換えます。

{ "mcpServers": { "mcp-tinybird": { "command": "uvx", "args": [ "mcp-tinybird", "stdio" ], "env": { "TB_API_URL": "<TINYBIRD_API_URL>", "TB_ADMIN_TOKEN": "<TINYBIRD_ADMIN_TOKEN>" } } } }
2. Claude Desktopを再起動します
SSEモード

あるいは、次のコマンドを実行して、MCP サーバーを SSE モードで実行することもできます。

uvx mcp-tinybird sse

このモードは、SSE をサポートする MCP クライアント (Web アプリなど) と統合する場合に便利です。

プロンプト

サーバーは単一のプロンプトを提供します:

  • tinybird-default : Tinybird にいくつかのデータがロードされており、それを探索するためのヘルプが必要であると想定します。
    • 探索するデータのトピックを定義する「topic」引数が必要です (例: 「Bluesky データ」または「小売売上」)。

追加のプロンプトワークフローを構成できます。

  • このスキーマを使用してワークスペースにプロンプトデータソースを作成し、プロンプトを追加します。MCPは初期化時にpromptsを読み込むので、必要に応じて設定できます。
SCHEMA > `name` String `json:$.name`, `description` String `json:$.description`, `timestamp` DateTime `json:$.timestamp`, `arguments` Array(String) `json:$.arguments[:]`, `prompt` String `json:$.prompt`

ツール

サーバーは、Tinybird Workspace と対話するためのいくつかのツールを実装しています。

  • list-data-sources : Tinybird ワークスペース内のすべてのデータソースを一覧表示します
  • list-pipes : Tinybird ワークスペース内のすべてのパイプエンドポイントを一覧表示します。
  • get-data-source : 指定された名前のデータ ソースの情報 (スキーマを含む) を取得します。
  • get-pipe : 指定された名前のパイプ エンドポイントの情報 (ノードや SQL 変換など) を取得し、提供される洞察を理解します。
  • request-pipe-data : HTTPリクエストを介してパイプエンドポイントからデータを要求します。パイプエンドポイントには、分析データをフィルタリングするためのパラメータを設定できます。
  • run-select-query : データ ソースに対して選択クエリを実行して分析情報を抽出できます。
  • append-insight : メモリソースに新しいビジネスインサイトを追加します
  • llms-tinybird-docs : Tinybird 製品のドキュメント全体が含まれているため、Tinybird の概要、機能、API リファレンスなどについてのコンテキストを取得するために使用できます。
  • save-event : Tinybirdデータソースにイベントを送信できます。ユーザーが生成したプロンプトをpromptsデータソースに保存するために使用します。MCPサーバーは初期化時にpromptsデータソースからフィードを受け取るため、ユーザーはLLMにワークフローを指示できます。
  • analyze-pipe : Tinybird analyze API を使用して、パイプエンドポイントクエリで ClickHouse explain を実行し、インデックス、ソートキー、パーティションキーが使用されているかどうかを確認し、最適化の提案を行います。
  • push-datafile : ローカルデータファイルからTinybirdワークスペースにリモートデータソースまたはパイプを作成します。このMCPサーバーによって生成されたファイルを保存するには、ファイルシステムMCPを使用します。

発達

設定

ローカルで作業している場合は、リポジトリのルートにある.envファイルに 2 つの環境変数を追加します。

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" ] } } }
"mcpServers": { "mcp-tinybird": { "command": "uvx", "args": [ "mcp-tinybird" ] } }

建築と出版

配布用のパッケージを準備するには:

  1. 依存関係を同期し、ロックファイルを更新します。
uv sync
  1. パッケージディストリビューションをビルドします。
uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

  1. PyPI に公開:
uv publish

注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。

  • トークン: --tokenまたはUV_PUBLISH_TOKEN
  • またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/alrocar/gr/mcp-tinybird run mcp-tinybird

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

監視

MCPサーバーを監視するには、 Grafanaなどの互換性のあるPrometheusクライアントを使用できます。MCPサーバーの監視方法については、こちらをご覧ください。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

任意の MCP クライアントから Tinybird Workspace と対話するための MCP サーバー。

  1. 特徴
    1. 使用例
      1. 設定
        1. インストール
        2. 前提条件
        3. 構成
      2. プロンプト
        1. ツール
          1. 発達
            1. 設定
            2. 建築と出版
            3. デバッグ
            4. 監視

          Related MCP Servers

          • Unstructured API MCP Serverofficial

            Unstructured-IO
            A
            security
            F
            license
            A
            quality
            An MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.
            Last updated -
            39
            28
            • Apple

          • Mattermost MCP Server

            pvev
            -
            security
            -
            license
            -
            quality
            An MCP server that enables Claude and other MCP clients to interact with Mattermost workspaces, providing channel management, messaging capabilities, and topic monitoring functionality.
            Last updated -
            TypeScript

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/tinybirdco/mcp-tinybird'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server