Tinybird MCP 서버

대장간 배지

모든 MCP 클라이언트에서 Tinybird Workspace와 상호 작용할 수 있는 MCP 서버입니다.

특징

Tinybird 쿼리 API를 사용하여 Tinybird 데이터 소스 쿼리
HTTP 요청을 통해 기존 Tinybird API 엔드포인트의 결과를 가져옵니다.
푸시 데이터 파일

SSE와 STDIO 모드를 모두 지원합니다.

Related MCP server: Lodestar MCP Server

사용 예

설정

설치

MCP 패키지 관리자 사용

대장간

Smithery 를 통해 Claude Desktop에 Tinybird MCP를 자동으로 설치하는 방법:

지엑스피1

mcp-get

mcp-get을 사용하여 Tinybird MCP 서버를 설치할 수 있습니다.

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

필수 조건

MCP는 아직 매우 새롭고 계속 발전하고 있으므로 MCP 기본 사항을 익히고 실행하려면 MCP 설명서를 따르는 것이 좋습니다.

필요한 것:

구성

1. Claude Desktop 구성

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 모드

또는 다음 명령을 실행하여 SSE 모드에서 MCP 서버를 실행할 수 있습니다.

uvx mcp-tinybird sse

이 모드는 SSE를 지원하는 MCP 클라이언트(웹 앱 등)와 통합하는 데 유용합니다.

프롬프트

서버는 단일 프롬프트를 제공합니다.

tinybird-default : Tinybird에 일부 데이터를 로드했고 이를 탐색하는 데 도움이 필요하다고 가정합니다.
- 탐색하려는 데이터의 주제를 정의하는 "주제" 인수가 필요합니다(예: "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 Workspace의 모든 데이터 소스를 나열합니다.
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 데이터 소스로 이벤트를 전송할 수 있습니다. 사용자가 생성한 프롬프트를 프롬프트 데이터 소스에 저장하는 데 사용합니다. MCP 서버는 초기화 시 프롬프트 데이터 소스에서 데이터를 제공하므로 사용자는 LLM에 따라야 할 워크플로를 지시할 수 있습니다.
analyze-pipe : Tinybird 분석 API를 사용하여 Pipe Endpoint 쿼리에 대한 ClickHouse 설명을 실행하고 인덱스, 정렬 키 및 파티션 키가 사용되고 있는지 확인하고 최적화 제안을 제안합니다.
push-datafile : 로컬 데이터 파일을 사용하여 Tinybird Workspace에 원격 데이터 소스 또는 파이프를 생성합니다. 파일 시스템 MCP를 사용하여 이 MCP 서버에서 생성된 파일을 저장합니다.

개발

구성

로컬로 작업하는 경우 저장소 루트에 있는 .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" ] } } }

"mcpServers": { "mcp-tinybird": { "command": "uvx", "args": [ "mcp-tinybird" ] } }

건축 및 출판

배포를 위해 패키지를 준비하려면:

종속성 동기화 및 잠금 파일 업데이트:

uv sync

패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

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

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

모니터링

MCP 서버를 모니터링하려면 Grafana 와 같은 호환되는 Prometheus 클라이언트를 사용할 수 있습니다. MCP 서버를 모니터링하는 방법은 여기에서 확인하세요.

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tinybird MCP server