Servidor Terra Config MCP

Un servidor de Protocolo de Contexto de Modelo que permite a los LLM configurar el tablero de TerraAPI.

Inicio rápido

Empiece rápidamente con una de estas opciones de instalación:

Para usuarios de Cursor

Para usuarios de VS Code

Herramientas disponibles

• terra_get_integrations
  • Descripción: Obtiene la lista de integraciones disponibles.
  • Parámetros: Ninguno
• terra_get_detailed_integrations
  • Descripción: Recupera una lista detallada de las integraciones soportadas, filtrada por las integraciones habilitadas del desarrollador y el requisito de uso del SDK.
  • Parámetros
    • sdk (Opcional[bool]): Si es true, permite que las integraciones SDK se incluyan en la respuesta.
• get_destinos
  • Descripción: Obtener destinos.
  • Parámetros: Ninguno
• get_developer_destination_credentials
  • Descripción: Obtiene las credenciales de destino del desarrollador.
  • Parámetros
    • destino (str): El destino para el que obtener las credenciales.
• eliminar_destino
  • Descripción: Elimina un destino.
  • Parámetros
    • destino (str): El destino a eliminar.
    • dev_id (Opcional[str]): ID del desarrollador. Si no se proporciona, utiliza la variable de entorno.
• set_destination_state
  • Descripción: Establece el estado del destino (activo o inactivo).
  • Parámetros
    • destino (str): El destino a actualizar.
    • active (bool): Si el destino debe estar activo o no.
• add_developer_destination
  • Descripción: Añade un destino desarrollador.
  • Parámetros
    • destino (str): El tipo de destino a añadir (por ejemplo, 's3', 'sql', 'webhook').
    • scheme (cadena): El esquema (por ejemplo 's3/postgres/https/mysql').
    • host (str): El host (por ejemplo, 'webhook.site', 'eu-west-2', 'localhost').
    • path (Opcional[str]): La ruta (por ejemplo, nombre del cubo, nombre de la base de datos, ruta del webhook sin '/' al principio).
    • user (Opcional[str]): Nombre de usuario para las credenciales.
    • password (Opcional[str]): Contraseña para las credenciales.
    • port (Opcional[int]): Puerto para el servicio si es necesario.
    • query (Opcional[str]): Cadena de consulta si es necesario.
    • certificate (Opcional[str]): Certificado para determinados destinos como GCS.
    • complete_destination (bool, por defecto: True): Si es true, hacer ping al destino antes de añadirlo.
• ping_destino_desarrollador
  • Descripción: Hace ping a un destino de desarrollador para comprobar si es accesible.
  • Parámetros
    • destino (str): El tipo de destino al que hacer ping.
    • scheme (str): El esquema (por ejemplo 's3/postgres/https/mysql').
    • host (str): El host (por ejemplo 'webhook.site', 'eu-west-2', 'localhost').
    • path (Opcional[str]): La ruta (por ejemplo, nombre del cubo, nombre de la base de datos, ruta del webhook).
    • user (Opcional[str]): Nombre de usuario para las credenciales.
    • password (Opcional[str]): Contraseña para las credenciales.
    • port (Opcional[int]): Puerto para el servicio si es necesario.
    • query (Opcional[str]): Cadena de consulta si es necesario.
    • certificate (Opcional[str]): Certificado para determinados destinos como GCS.
• set_provider_keys
  • Descripción: Establece las claves del proveedor.
  • Parámetros
    • resource (str): El recurso del proveedor.
    • client_id (str): El ID del cliente para el proveedor.
    • client_secret (cadena): El secreto de cliente del proveedor.
    • redirect_url (Opcional[str]): La URL de redirección del proveedor.
• obtener_claves_del_proveedor
  • Descripción: Obtiene las claves del proveedor.
  • Parámetros
    • resource (str): El recurso del proveedor.
• get_developer_providers
  • Descripción: Obtiene los proveedores del desarrollador.
  • Parámetros: Ninguno
• añadir_proveedores
  • Descripción: Añade proveedores.
  • Parámetros
    • providers (list[str]): lista de proveedores a añadir.
• desactivar_proveedor
  • Descripción: Eliminar proveedor.
  • Parámetros
    • proveedor (str): El proveedor a desactivar.
• set_provider_state
  • Descripción: Establece el estado del proveedor (activo o inactivo).
  • Parámetros
    • proveedor (str): El proveedor a actualizar.
    • activo (bool): Si el proveedor debe estar activo o no.
• get_providers_by_popularity
  • Descripción: Obtiene los proveedores ordenados por popularidad.
  • Parámetros: Ninguno
• add_custom_credentials
  • Descripción: Añade credenciales personalizadas para un proveedor.
  • Parámetros
    • proveedor (str): El proveedor para el que añadir credenciales.
    • client_id (cadena): El ID del cliente.
    • client_secret (cadena): El secreto del cliente.
    • redirect_url (Opcional[str]): La URL de redirección.
• get_custom_credentials
  • Descripción: Obtiene las credenciales personalizadas de un proveedor.
  • Parámetros
    • proveedor (cadena): El proveedor para el que obtener las credenciales.

Instalación

[Necesitarás tu TERRA_API_KEY y TERRA_DEV_ID que está disponible en el dashboard

Usando uv (recomendado)

Cuando se utiliza uv no es necesaria ninguna instalación específica. Usaremos uvx para ejecutar directamente terramcp.

instalación deuv

Mac / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Usando PIP

Alternativamente, puede instalar terramcp a través de pip:

pip install terramcp

Después de la instalación, puede ejecutarlo como un script usando:

python -m terramcp

Configuración

Configurar para Claude.app

Añade a tu configuración Claude:

{ "mcpServers": { "terramcp": { "command": "uvx", "args": ["terramcp"], "env": { "TERRA_API_KEY": "tu_clave_api_aquí", "TERRA_DEV_ID": "your-dev-id-here" } } }

{ "mcpServers": { "terramcp": { "command": "python", "args": ["-m", "terramcp"], "env": { "TERRA_API_KEY": "tu_clave_api_aquí", "TERRA_DEV_ID": "your-dev-id-here" } } }

Configurar para Zed

Añade a tu Zed settings.json:

"context_servers": [ "terramcp": { "command": "uvx", "args": ["terramcp"], "env": { "TERRA_API_KEY": "tu_clave_api_aquí", "TERRA_DEV_ID": "your-dev-id-here" } } ],

"context_servers": { "terramcp": { "command": "python", "args": ["-m", "terramcp"], "env": { "TERRA_API_KEY": "tu_clave_api_aquí", "TERRA_DEV_ID": "your-dev-id-here" } },

Configurar para VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un clic a continuación...

Para una instalación manual, añada el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Puede hacerlo pulsando Ctrl + Mayús + P y escribiendo Preferencias: Abrir Configuración de Usuario (JSON).

Opcionalmente, puede añadirlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otras personas.

Tenga en cuenta que la clave mcp es necesaria cuando se utiliza el archivo mcp.json.

{ "mcp": { "servers": { "terramcp": { "command": "uvx", "args": ["terramcp"], "env": { "TERRA_API_KEY": "tu_clave_api_aquí", "TERRA_DEV_ID": "your-dev-id-here" } } } }

Depuración

Puede utilizar el inspector MCP para depurar el servidor. Para instalaciones uvx:

npx @modelcontextprotocol/inspector uvx terramcp

O si has instalado el paquete en un directorio específico o estás desarrollando sobre él:

cd path/to/servers/src/terramcp npx @modelcontextprotocol/inspector uv run terramcp

Licencia

terramcp está licenciado bajo la Licencia MIT. Esto significa que usted es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.