Terra

Terra Config MCP Server

Un servidor de Protocolo de Contexto de Modelo que permite a los LLMs configurar el panel de TerraAPI.

Inicio rápido

Comience 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: Obtener lista de integraciones disponibles.
  • Parámetros: Ninguno
• terra_get_detailed_integrations
  • Descripción: Recuperar una lista detallada de integraciones compatibles, filtrada por las integraciones habilitadas del desarrollador y el requisito de uso del SDK.
  • Parámetros:
    • sdk (Optional[bool]): Si es verdadero, permite que las integraciones SDK se incluyan en la respuesta.
• get_destinations
  • Descripción: Obtener destinos.
  • Parámetros: Ninguno
• get_developer_destination_credentials
  • Descripción: Obtener credenciales de destino del desarrollador.
  • Parámetros:
    • destination (str): El destino para el cual obtener credenciales.
• delete_destination
  • Descripción: Eliminar un destino.
  • Parámetros:
    • destination (str): El destino a eliminar.
    • dev_id (Optional[str]): ID del desarrollador. Si no se proporciona, usa la variable de entorno.
• set_destination_state
  • Descripción: Establecer el estado del destino (activo o inactivo).
  • Parámetros:
    • destination (str): El destino a actualizar.
    • active (bool): Si el destino debe estar activo o no.
• add_developer_destination
  • Descripción: Agregar destino de desarrollador.
  • Parámetros:
    • destination (str): El tipo de destino a agregar (p. ej. 's3', 'sql', 'webhook').
    • scheme (str): El esquema (p. ej. 's3/postgres/https/mysql').
    • host (str): El host (p. ej. 'webhook.site', 'eu-west-2', 'localhost').
    • path (Optional[str]): La ruta (p. ej. nombre del bucket, nombre de la base de datos, ruta del webhook sin '/' inicial).
    • user (Optional[str]): Nombre de usuario para las credenciales.
    • password (Optional[str]): Contraseña para las credenciales.
    • port (Optional[int]): Puerto para el servicio si es necesario.
    • query (Optional[str]): Cadena de consulta si es necesario.
    • certificate (Optional[str]): Certificado para ciertos destinos como GCS.
    • complete_destination (bool, default: True): Si es verdadero, hacer ping al destino antes de agregarlo.
• ping_developer_destination
  • Descripción: Hacer ping a un destino de desarrollador para verificar si es accesible.
  • Parámetros:
    • destination (str): El tipo de destino al que hacer ping.
    • scheme (str): El esquema (p. ej. 's3/postgres/https/mysql').
    • host (str): El host (p. ej. 'webhook.site', 'eu-west-2', 'localhost').
    • path (Optional[str]): La ruta (p. ej. nombre del bucket, nombre de la base de datos, ruta del webhook).
    • user (Optional[str]): Nombre de usuario para las credenciales.
    • password (Optional[str]): Contraseña para las credenciales.
    • port (Optional[int]): Puerto para el servicio si es necesario.
    • query (Optional[str]): Cadena de consulta si es necesario.
    • certificate (Optional[str]): Certificado para ciertos destinos como GCS.
• set_provider_keys
  • Descripción: Establecer claves de proveedor.
  • Parámetros:
    • resource (str): El recurso del proveedor.
    • client_id (str): El ID de cliente para el proveedor.
    • client_secret (str): El secreto de cliente para el proveedor.
    • redirect_url (Optional[str]): La URL de redirección para el proveedor.
• get_provider_keys
  • Descripción: Obtener claves de proveedor.
  • Parámetros:
    • resource (str): El recurso del proveedor.
• get_developer_providers
  • Descripción: Obtener proveedores del desarrollador.
  • Parámetros: Ninguno
• add_providers
  • Descripción: Agregar proveedores.
  • Parámetros:
    • providers (list[str]): lista de proveedores a agregar.
• deactivate_provider
  • Descripción: Eliminar proveedor.
  • Parámetros:
    • provider (str): El proveedor a desactivar.
• set_provider_state
  • Descripción: Establecer el estado del proveedor (activo o inactivo).
  • Parámetros:
    • provider (str): El proveedor a actualizar.
    • active (bool): Si el proveedor debe estar activo o no.
• get_providers_by_popularity
  • Descripción: Obtener proveedores clasificados por popularidad.
  • Parámetros: Ninguno
• add_custom_credentials
  • Descripción: Agregar credenciales personalizadas para un proveedor.
  • Parámetros:
    • provider (str): El proveedor para el cual agregar credenciales.
    • client_id (str): El ID de cliente.
    • client_secret (str): El secreto de cliente.
    • redirect_url (Optional[str]): La URL de redirección.
• get_custom_credentials
  • Descripción: Obtener credenciales personalizadas para un proveedor.
  • Parámetros:
    • provider (str): El proveedor para el cual obtener credenciales.

Instalación

[!NOTE] Necesitará su TERRA_API_KEY y TERRA_DEV_ID que están disponibles desde el panel

Usando uv (recomendado)

Cuando se usa uv no se necesita instalación específica. Usaremos uvx para ejecutar directamente terramcp.

Instalación de uv

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 mediante 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

Agregue a su configuración de Claude:

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

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

Configurar para Zed

Agregue a su settings.json de Zed:

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

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

Configurar para VS Code

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

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de Configuración de Usuario (JSON) en VS Code. Puede hacer esto presionando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON) .

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

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

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

Depuración

Puede usar el inspector de MCP para depurar el servidor. Para instalaciones con uvx:

npx @modelcontextprotocol/inspector uvx terramcp

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

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

Licencia

terramcp está licenciado bajo la Licencia MIT. Esto significa que 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.