Servidor Tecton MCP

Reglas del servidor y cursor de Tecton MCP

El Copiloto de Tecton consta de un servidor MCP y reglas de cursor. Lea este blog para obtener más información.

ℹ️ Información : Esta guía lo guiará a través de la configuración del servidor Tecton MCP con este repositorio y la configuración de su repositorio de funciones para usarlo mientras desarrolla funciones con Tecton.

Tabla de contenido

Inicio rápido
Herramientas Tecton MCP
Arquitectura
Configurar Tecton con el cursor
Cómo utilizar una versión específica del SDK de Tecton
Solución de problemas
Recursos

Inicio rápido

Clone este repositorio en su máquina local:
git clone https://github.com/tecton-ai/tecton-mcp.git cd tecton-mcp pwd
Nota: La ruta al directorio donde acaba de clonar el repositorio se llamará <path-to-your-local-clone> en los siguientes pasos. El comando pwd al final le indicará la ruta completa.
Instalar el administrador de paquetes uv:
brew install uv
Verifique su instalación ejecutando el siguiente comando. Reemplace <path-to-your-local-clone> con la ruta donde clonó el repositorio en el paso 1:
MCP_SMOKE_TEST=1 uv --directory <path-to-your-local-clone> run mcp run src/tecton_mcp/mcp_server/server.py
El comando debería salir sin errores e imprimir un mensaje similar a MCP_SMOKE_TEST is set. Exiting after initialization. . Esto confirma que la configuración local funciona correctamente: Cursor generará automáticamente el servidor MCP como subproceso cuando sea necesario.
Configurar Cursor (o cualquier otro cliente MCP) con el servidor MCP (ver a continuación)
Inicie sesión en su clúster Tecton:
tecton login yourcluster.tecton.ai
¡Ejecuta Cursor y comienza a desarrollar funciones con Co-Pilot de Tecton en Cursor!

Herramientas Tecton MCP

El servidor Tecton MCP expone las siguientes herramientas que pueden ser utilizadas por un cliente MCP (como Cursor):

Nombre de la herramienta	Descripción
`query_example_code_snippet_index_tool`	Encuentra ejemplos de código Tecton relevantes mediante una base de datos vectorial. Útil para identificar patrones de uso antes de escribir nuevo código Tecton.
`query_documentation_index_tool`	Recupera fragmentos de documentación de Tecton mediante una consulta. Proporciona contexto directamente de la documentación oficial de Tecton.
`get_full_tecton_sdk_reference_tool`	Obtiene la referencia completa del SDK de Tecton, incluyendo todas las clases y funciones disponibles. Úselo cuando se necesite una visión general del SDK.
`query_tecton_sdk_reference_tool`	Obtiene la referencia del SDK de Tecton para una lista específica de clases o funciones. Ideal para obtener información específica sobre componentes específicos del SDK.

Arquitectura

Tecton MCP se integra con editores potenciados por LLM como Cursor para brindar contexto basado en herramientas y asistencia para la ingeniería de funciones:

Arquitectura Tecton MCP

El flujo general para crear funciones con Tecton MCP se ve así:

Diagrama de flujo de Tecton MCP

Configurar Tecton con el cursor

Lo siguiente se prueba con Cursor 0.48 y superior

Configurar el servidor Tecton MCP en Cursor

Vaya a Configuración de Cursor -> MCP y haga clic en el botón "Añadir nuevo servidor MCP global". Esto editará el archivo mcp.json de Cursor. Añada Tecton como servidor MCP. Puede usar la siguiente configuración como punto de partida; asegúrese de modificar la ruta <path-to-your-local-clone> para que coincida con el directorio donde clonó el repositorio:

{
    "mcpServers": {
        "tecton": {
            "command": "uv",
            "args": [
                "--directory",
                "<path-to-your-local-clone>",
                "run",
                "mcp",
                "run", 
                "src/tecton_mcp/mcp_server/server.py"
            ]
        }
    }
}

Agregar reglas de cursor

Copie las reglas de cursor de la carpeta .cursor/rules de este repositorio a la carpeta .cursor/rules de su repositorio de funciones :

# Create the .cursor/rules directory structure in your feature repository
mkdir -p <path-to-your-feature-repo>/.cursor/rules

# Then copy the rules
cp -r <path-to-your-local-clone>/.cursor/rules/* <path-to-your-feature-repo>/.cursor/rules/

Inicio de sesión en Tecton

Inicie sesión en su clúster Tecton:

    tecton login yourcluster.tecton.ai

LLM recomendado

Al 17 de abril, la siguiente es la lista clasificada por pila de los LLM de ingeniería de características de Tecton con mejor rendimiento en Cursor:

OpenAI o3
Experiencia profesional de Gemini 2.5 (25/03)
Soneto 3.7

Verifique que la integración Cursor <> Tecton MCP funcione como se espera

Para asegurarse de que su integración funcione como se espera, formule una pregunta como la siguiente al Agente Cursor y asegúrese de que invoque correctamente sus herramientas Tecton MCP:

Consulta el índice de ejemplos de Tecton y cuéntame algo sobre BatchFeatureViews y en qué se diferencian de StreamFeatureViews. Consulta también la referencia del SDK.

Comience la ingeniería de funciones asistida por IA :-)

Ahora puedes ir a tu Repositorio de funciones en Cursor y comenzar a utilizar Co-Pilot de Tecton, integrado directamente en Cursor.

Vea este Loom para ver cómo puede usar la integración para crear nuevas funciones: https://www.loom.com/share/3658f665668a41d2b0ea2355b433c616

Cómo utilizar una versión específica del SDK de Tecton

De forma predeterminada, esta herramienta proporciona orientación para la última versión preliminar del SDK de Tecton. Si necesita las herramientas para adaptarse a una versión específica de Tecton (por ejemplo, 1.0.34 o 1.1.10 ), siga estos pasos:

Fije la versión en pyproject.toml . Abra pyproject.toml y reemplace la línea de dependencia existente.

dependencies = [
  # ... other dependencies ...
  "tecton>=0.8.0a0"
]

con la versión exacta que quieras, por ejemplo

dependencies = [
  # ... other dependencies ...
  "tecton==1.1.10"
]

Elimine el archivo de bloqueo existente. Dado que uv.lock registra el gráfico de dependencias, debe eliminarlo para que uv pueda resolver la nueva versión de Tecton:

cd <path-to-your-local-clone>
rm uv.lock

Regenere el archivo de bloqueo ejecutando nuevamente el paso 3 (comando MCP_SMOKE_TEST=1 uv --directory ) de la sección de Inicio rápido . (Esto descargará la versión anclada en un entorno aislado para MCP y recreará uv.lock ).
Reinicie Cursor para que la nueva versión de Tecton se cargue en el entorno virtual MCP.

Versiones compatibles: Las herramientas son compatibles actualmente con Tecton ≥ 1.0.0. Los ejemplos de código aún no tienen versiones; siempre usan el SDK estable más reciente. Sin embargo, la documentación y los índices de referencia del SDK ahora coincidirán con la versión que haya fijado.

Solución de problemas

Integración del servidor Cursor <-> Tecton MCP

Asegúrese de que el cursor muestre "tecton" como servidor MCP "Habilitado" en "Configuración del cursor -> MCP". Si no ve un punto verde, ejecute el servidor MCP en modo de diagnóstico (ver más abajo).

Ejecutar MCP en modo de diagnóstico

Para depurar el servidor Tecton MCP, ejecute el siguiente comando. Reemplace <path-to-your-local-clone> con la ruta donde clonó el repositorio:

uv --directory <path-to-your-local-clone> run mcp dev src/tecton_mcp/mcp_server/server.py

Nota: El inicio del servidor MCP de Tecton tardará unos segundos porque está cargando un modelo de incrustación en la memoria que utiliza para buscar fragmentos de código relevantes.

Espere unos segundos hasta que la salida estándar le indique que el Inspector MCP está en funcionamiento y luego acceda a él en la URL impresa (algo así como http://localhost:5173 )

Haga clic en "Conectar" y luego en la lista de herramientas. Debería ver las herramientas del servidor Tecton MCP y poder consultarlas.

Recursos

Licencia

Este proyecto está licenciado bajo la licencia MIT .

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Proporciona un conjunto de herramientas para interactuar con clústeres de Tecton, administrar almacenes de características y ejecutar comandos CLI de Tecton a través del Protocolo de control de misión.

Related Resources

Reddit Discussion about this server

Related MCP Servers

cosense-mcp-server
yosider
-
security
F
license
-
quality
The cosense-mcp-server facilitates the integration with Claude Desktop by serving as a middleware command pipeline server, allowing for interaction with projects in cosense.
Last updated -
7
3
TypeScript
Vercel MCP Server
Quegenx
A
security
F
license
A
quality
A powerful Model Context Protocol (MCP) server enabling seamless Vercel project management, including deployments, domains, environment variables, and team configurations through Cursor's Composer or Codeium's Cascade.
Last updated -
65
17
TypeScript
tfmcp
nwiizo
-
security
A
license
-
quality
🌍 Terraform Model Context Protocol (MCP) Tool - An experimental CLI tool that enables AI assistants to manage and operate Terraform environments. Supports reading Terraform configurations, analyzing plans, applying configurations, and managing state with Claude Desktop integration. ⚡️
Last updated -
292
Rust
MIT License
Salesforce CLI MCP Server
codefriar
A
security
F
license
A
quality
Exposes Salesforce CLI functionality to LLM tools like Claude Desktop, allowing AI agents to execute Salesforce commands, manage orgs, deploy code, and query data through natural language.
Last updated -
5
72
28
JavaScript

View all related MCP servers

Tecton MCP Server