Serveur Terra Config MCP

Un serveur Model Context Protocol qui permet aux LLM de configurer le tableau de bord TerraAPI.

Démarrage rapide

Démarrez rapidement avec l'une de ces options d'installation :

Pour les utilisateurs de Cursor

Pour les utilisateurs de VS Code

Outils disponibles

• terra_get_integrations
  • Description : Obtenir la liste des intégrations disponibles.
  • Paramètres : Aucun
• terra_get_detailed_integrations
  • Description : Récupère une liste détaillée des intégrations prises en charge, filtrée en fonction des intégrations activées par le développeur et de la nécessité d'utiliser le SDK.
  • Paramètres
    • sdk (Facultatif[bool]) : Si true, permet d'inclure les intégrations SDK dans la réponse.
• get_destinations
  • Description : Permet d'obtenir des destinations.
  • Paramètres : Aucun
• get_developer_destination_credentials
  • Description : Obtenir les informations d'identification de la destination du développeur.
  • Paramètres
    • destination (chaîne) : La destination pour laquelle les informations d'identification doivent être obtenues.
• delete_destination
  • Description : Supprime une destination.
  • Paramètres
    • destination (str) : La destination à supprimer.
    • dev_id (Facultatif[str]) : ID du développeur. S'il n'est pas fourni, il utilise la variable d'environnement.
• set_destination_state
  • Description : Définit l'état de la destination (actif ou inactif).
  • Paramètres
    • destination (str) : La destination à mettre à jour.
    • active (bool) : Indique si la destination doit être active ou non.
• add_developer_destination
  • Description : Ajouter une destination de développeur.
  • Paramètres
    • destination (str) : Le type de destination à ajouter (par exemple, "s3", "sql", "webhook").
    • scheme (chaîne) : Le schéma (par exemple 's3/postgres/https/mysql').
    • host (chaîne) : L'hôte (par exemple "webhook.site", "eu-west-2", "localhost").
    • path (Optional[str]) : Le chemin (par exemple, le nom du seau, le nom de la base de données, le chemin du webhook sans le '/' de tête).
    • user (Facultatif[str]) : Nom d'utilisateur pour les informations d'identification.
    • password (Facultatif [chaîne]) : Mot de passe pour les informations d'identification.
    • port (Facultatif[int]) : Port du service si nécessaire.
    • query (Facultatif[str]) : Chaîne de requête si nécessaire.
    • certificate (Facultatif[str]) : Certificat pour certaines destinations comme GCS.
    • complete_destination (bool, default : True) : Si vrai, envoyer un ping à la destination avant de l'ajouter.
• ping_developer_destination
  • Description : Effectue un ping vers une destination de développeur pour vérifier si elle est accessible.
  • Paramètres
    • destination (str) : Le type de destination à interroger.
    • scheme (str) : Le schéma (par exemple 's3/postgres/https/mysql').
    • host (chaîne) : L'hôte (par exemple "webhook.site", "eu-west-2", "localhost").
    • path (Optional[str]) : Le chemin (par exemple, le nom du seau, le nom de la base de données, le chemin du webhook).
    • user (Facultatif [chaîne]) : Nom d'utilisateur pour les informations d'identification.
    • password (Facultatif[chaîne]) : Mot de passe pour les informations d'identification.
    • port (Facultatif[int]) : Port du service si nécessaire.
    • query (Facultatif[str]) : Chaîne de requête si nécessaire.
    • certificate (Facultatif[str]) : Certificat pour certaines destinations comme GCS.
• set_provider_keys
  • Description : Définir les clés du fournisseur.
  • Paramètres
    • resource (str) : La ressource du fournisseur.
    • client_id (str) : L'identifiant du client pour le fournisseur.
    • client_secret (str) : Le secret du client pour le fournisseur.
    • redirect_url (Optional[str]) : L'URL de redirection du fournisseur : L'URL de redirection du fournisseur.
• get_provider_keys
  • Description : Obtenir les clés du fournisseur.
  • Paramètres
    • resource (str) : La ressource du fournisseur.
• get_developer_providers
  • Description : Permet d'obtenir les fournisseurs des développeurs.
  • Paramètres : Aucun
• add_providers
  • Description : Ajouter des fournisseurs.
  • Paramètres
    • providers (list[str]) : liste des fournisseurs à ajouter.
• désactiver_fournisseur
  • Description : Supprime un fournisseur.
  • Paramètres
    • fournisseur (chaîne) : Le fournisseur à désactiver.
• set_provider_state
  • Description : Définir l'état du fournisseur (actif ou inactif).
  • Paramètres
    • provider (str) : Le fournisseur à mettre à jour.
    • active (bool) : Indique si le fournisseur doit être actif ou non.
• get_providers_by_popularity
  • Description : Permet d'obtenir les fournisseurs classés par popularité.
  • Paramètres : Aucun
• add_custom_credentials
  • Description : Ajoute des informations d'identification personnalisées pour un fournisseur.
  • Paramètres
    • fournisseur (chaîne) : Le fournisseur pour lequel des informations d'identification doivent être ajoutées.
    • client_id (chaîne) : L'identifiant du client.
    • client_secret (chaîne) : Le secret du client.
    • redirect_url (Facultatif[str]) : L'URL de redirection.
• get_custom_credentials
  • Description : Obtenir des informations d'identification personnalisées pour un fournisseur.
  • Paramètres
    • fournisseur (chaîne) : Le fournisseur pour lequel les informations d'identification doivent être obtenues.

Installation

[Vous aurez besoin de votre TERRA_API_KEY et TERRA_DEV_ID qui sont disponibles dans le tableau de bord

Utilisation d'uv (recommandé)

L'utilisation de uv ne nécessite pas d'installation spécifique. Nous utiliserons uvx pour exécuter directement terramcp.

installation 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"

Utilisation de PIP

Vous pouvez également installer terramcp via pip :

pip install terramcp

Après l'installation, vous pouvez l'exécuter en tant que script en utilisant :

python -m terramcp

Configuration

Configuration pour Claude.app

Ajoutez à vos paramètres 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" : "votre_clé_api_ici", "TERRA_DEV_ID" : "your-dev-id-here" } } } }

Configuration pour Zed

Ajoutez à votre settings.json 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" : "votre_clé_api_ici", "TERRA_DEV_ID" : "your-dev-id-here" } },

Configuration pour VS Code

Pour une installation rapide, utilisez l'un des boutons d'installation en un clic ci-dessous...

Pour une installation manuelle, ajoutez le bloc JSON suivant à votre fichier User Settings (JSON) dans VS Code. Vous pouvez le faire en appuyant sur Ctrl + Shift + P et en tapant Preferences : Ouvrir les paramètres de l'utilisateur (JSON).

Vous pouvez également l'ajouter à un fichier appelé .vscode/mcp.json dans votre espace de travail. Cela vous permettra de partager la configuration avec d'autres personnes.

Notez que la clé mcp est nécessaire lors de l'utilisation du fichier mcp.json.

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

Débogage

Vous pouvez utiliser l'inspecteur MCP pour déboguer le serveur. Pour les installations uvx :

npx @modelcontextprotocol/inspector uvx terramcp

Ou si vous avez installé le paquet dans un répertoire spécifique ou si vous développez dessus :

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

Licence d'utilisation

terramcp est placé sous licence MIT. Cela signifie que vous êtes libre d'utiliser, de modifier et de distribuer le logiciel, sous réserve des termes et conditions de la licence MIT. Pour plus de détails, veuillez consulter le fichier LICENSE dans le référentiel du projet.