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.

Integrations

Enables analysis of Bluesky data through integration with Tinybird, as demonstrated in usage examples including metrics visualization.
Supports ClickHouse query analysis through the analyze-pipe tool, which provides optimization suggestions for query performance, indexes, sorting keys, and partition keys.
Provides compatibility with Grafana for monitoring the MCP server through Prometheus clients.

Servidor MCP de Tinybird

Un servidor MCP para interactuar con un espacio de trabajo Tinybird desde cualquier cliente MCP.

Características

Consultar fuentes de datos de Tinybird mediante la API de consulta de Tinybird
Obtenga el resultado de los puntos finales de la API de Tinybird existentes con solicitudes HTTP
Archivos de datos push

Admite los modos SSE y STDIO.

Ejemplos de uso

Configuración

Instalación

Uso de administradores de paquetes MCP

Herrería

Para instalar Tinybird MCP para Claude Desktop automáticamente a través de Smithery :

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

mcp-get

Puede instalar el servidor Tinybird MCP usando mcp-get :

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

Prerrequisitos

MCP todavía es muy nuevo y está en constante evolución; recomendamos seguir la documentación de MCP para poner en funcionamiento los conceptos básicos de MCP.

Necesitarás:

Configuración

1. Configurar Claude Desktop

Crea el siguiente archivo dependiendo de tu sistema operativo:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

Pegue esta plantilla en el archivo y reemplace <TINYBIRD_API_URL> y <TINYBIRD_ADMIN_TOKEN> con la URL de API de Tinybird y el token de administrador:

{
    "mcpServers": {
        "mcp-tinybird": {
            "command": "uvx",
            "args": [
                "mcp-tinybird",
                "stdio"
            ],
            "env": {
                "TB_API_URL": "<TINYBIRD_API_URL>",
                "TB_ADMIN_TOKEN": "<TINYBIRD_ADMIN_TOKEN>"
            }
        }
    }
}

2. Reinicie Claude Desktop

Modo SSE

Alternativamente, puede ejecutar el servidor MCP en modo SSE ejecutando el siguiente comando:

uvx mcp-tinybird sse

Este modo es útil para integrarse con un cliente MCP que admita SSE (como una aplicación web).

Indicaciones

El servidor proporciona un único mensaje:

tinybird-default : supone que ha cargado algunos datos en Tinybird y desea ayuda para explorarlos.
- Requiere un argumento "tema" que define el tema de los datos que desea explorar, por ejemplo, "datos de Bluesky" o "ventas minoristas".

Puede configurar flujos de trabajo de aviso adicionales:

Cree una fuente de datos de indicaciones en su espacio de trabajo con este esquema y añada sus indicaciones. El MCP carga prompts al inicializarse para que pueda configurarlo según sus necesidades:

SCHEMA >
    `name` String `json:$.name`,
    `description` String `json:$.description`,
    `timestamp` DateTime `json:$.timestamp`,
    `arguments` Array(String) `json:$.arguments[:]`,
    `prompt` String `json:$.prompt`

Herramientas

El servidor implementa varias herramientas para interactuar con el espacio de trabajo de Tinybird:

list-data-sources : enumera todas las fuentes de datos en el espacio de trabajo de Tinybird
list-pipes : enumera todos los puntos finales de tubería en el espacio de trabajo de Tinybird
get-data-source : obtiene la información de una fuente de datos dado su nombre, incluido el esquema.
get-pipe : obtiene la información de un punto final de tubería dado su nombre, incluidos sus nodos y la transformación SQL para comprender qué información proporciona.
request-pipe-data : Solicita datos de los puntos finales de una tubería mediante una solicitud HTTP. Los puntos finales de la tubería pueden tener parámetros para filtrar los datos analíticos.
run-select-query : permite ejecutar una consulta de selección sobre una fuente de datos para extraer información.
append-insight : agrega una nueva perspectiva empresarial al recurso de nota
llms-tinybird-docs : contiene toda la documentación del producto Tinybird, por lo que puede usarla para obtener contexto sobre qué es Tinybird, qué hace, referencia de API y más.
save-event : Permite enviar un evento a una fuente de datos de Tinybird. Úselo para guardar un mensaje generado por el usuario en dicha fuente. El servidor MCP se alimenta de la fuente de datos durante la inicialización para que el usuario pueda indicar al LLM el flujo de trabajo a seguir.
analyze-pipe : utiliza la API de análisis de Tinybird para ejecutar una explicación de ClickHouse en la consulta del punto final de la tubería y verificar si se están utilizando los índices, la clave de clasificación y la clave de partición y proponer sugerencias de optimizaciones.
push-datafile : Crea una fuente de datos o canalización remota en el espacio de trabajo de Tinybird a partir de un archivo de datos local. Utiliza el MCP del sistema de archivos para guardar los archivos generados por este servidor MCP.

Desarrollo

Configuración

Si está trabajando localmente, agregue dos variables de entorno a un archivo .env en la raíz del repositorio:

TB_API_URL=
TB_ADMIN_TOKEN=

Para el desarrollo local, actualice la configuración de 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"
    ]
  }
}

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

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

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Escucha

Para supervisar el servidor MCP, puede usar cualquier cliente Prometheus compatible, como Grafana . Aprenda a supervisar su servidor MCP aquí .

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Un servidor MCP para interactuar con un espacio de trabajo Tinybird desde cualquier cliente MCP.

Tinybird MCP server

Integrations

Servidor MCP de Tinybird

Características

Ejemplos de uso

Configuración

Instalación

Uso de administradores de paquetes MCP

Prerrequisitos

Configuración

1. Configurar Claude Desktop

2. Reinicie Claude Desktop

Modo SSE

Indicaciones

Herramientas

Desarrollo

Configuración

Construcción y publicación

Depuración

Escucha

Appeared in Searches