Serveur MCP de Code Ocean

Serveur MCP (Model Context Protocol) pour Code Ocean.

Ce serveur MCP fournit des outils pour rechercher et exécuter des capsules et des pipelines, et pour gérer les données.

Table des matières

• Prérequis
• Installation du serveurMCP
  • Code Visual Studio
  • Bureau Claude
  • Cline
  • Code Roo
  • Curseur
  • Windsurf

Prérequis

1. Installer uv à partir d'Astral ou du README de GitHub
2. Installer Python 3.10 ou plus récent en utilisant uv python install 3.10 (ou une version plus récente)
3. Générer un jeton d'accès Code Ocean. Suivez les instructions du guide d'utilisation de Code Ocean.

Installation

Code Visual Studio

Voici un exemple de configuration du serveur MCP de VS Code :

{ ... "mcp" : { "inputs" : [ { "type" : "promptString", "id" : "codeocean-token", "description" : "Code Ocean API Key", "password" : true } ], "servers" : { "codeocean" : { "type" : "stdio", "command" : "uvx", "args" : ["codeocean-mcp-server"], "env" : { "CODEOCEAN_DOMAIN" : "https://codeocean.acme.com", "CODEOCEAN_TOKEN" : "${input:codeocean-token}", "AGENT_ID" : "VS Code" } } }, } }

Bureau Claude

1. Ouvrez le fichier claude_desktop_config.json:

• macOS : ~/Bibliothèque/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claudeclaude_desktop_config.json

2. Sous l'objet de premier niveau "mcpServers", ajoutez une entrée "codeocean". Pour un transport stdio (processus enfant), cela ressemble à ceci :

{ "mcpServers" : { "codeocean" : {"command" : "uvx", "args" : ["codeocean-mcp-server"], "env" : { "CODEOCEAN_DOMAIN" : "https://codeocean.acme.com", "CODEOCEAN_TOKEN" : "<VOTRE_CLÉ_API>", "AGENT_ID" : "Claude Desktop" } } }

Cline

Cline stocke tous ses paramètres MCP dans un fichier JSON appelé cline_mcp_settings.json. Vous pouvez le modifier soit via l'interface graphique ("Configure MCP Servers" dans le volet MCP Servers), soit à la main :

1. Ouvrez Cline et cliquez sur l'icône MCP Servers dans la barre latérale.
2. Dans l'onglet "Installed", cliquez sur Configure MCP Servers → ceci ouvre votre fichier cline_mcp_settings.json.
3. Ajoutez un serveur "codeocean" sous la clé "mcpServers". Pour le transport stdio :

{ "mcpServers" : { "codeocean" : { "command" : "uvx", "args" : ["codeocean-mcp-server"], "env" : { "CODEOCEAN_DOMAIN" : "https://codeocean.acme.com", "CODEOCEAN_TOKEN" : "<YOUR_API_KEY>", "AGENT_ID" : "Cline" }, "alwaysAllow" : [], // optional : list of tools to auto-approve "disabled" : false // ensure it's enabled } } }

4. Enregistrez le fichier. Cline détectera et lancera automatiquement le nouveau serveur, rendant vos outils Code Ocean disponibles dans le chat .

Roo Code

Le support MCP de Roo Code est configuré globalement dans tous les espaces de travail via un fichier de paramètres JSON ou via son interface utilisateur dédiée aux paramètres MCP

Via l'interface utilisateur des paramètres MCP :

1. Cliquez sur l'icône MCP dans la barre latérale de Roo Code. 
2. Sélectionnez Editer les paramètres MCP (ouvre cline_mcp_settings.json). 
3. Sous "mcpServers", ajoutez :

{ "mcpServers" : { "codeocean" : { "command" : "uvx", "args" : ["codeocean-mcp-server"], "env" : { "CODEOCEAN_DOMAIN" : "https://codeocean.acme.com", "CODEOCEAN_TOKEN" : "<YOUR_API_KEY>", "AGENT_ID" : "Roo Code" } } }

4. Sauvegardez et redémarrez Roo Code ; vos outils Code Ocean apparaîtront automatiquement.

Facultatif : Modification manuelle de cline_mcp_settings.json

1. Localisez cline_mcp_settings.json (dans votre répertoire personnel ou votre espace de travail). 
2. Insérez le même bloc "codeocean" sous "mcpServers" que ci-dessus.
3. Sauvegardez et redémarrez.

Cursor

Cursor stocke les serveurs MCP dans un fichier JSON, soit ~/.cursor/mcp.json (global), soit {projet}/.cursor/mcp.json (spécifique à un projet) .

1. Ouvrir .cursor/mcp.json (ou le créer s'il manque). 
2. Ajouter sous "mcpServers" :

{ "mcpServers" : { "codeocean" : { "command" : "uvx", "args" : ["codeocean-mcp-server"], "env" : { "CODEOCEAN_DOMAIN" : "https://codeocean.acme.com", "CODEOCEAN_TOKEN" : "<VOTRE_CLÉ_API>", "AGENT_ID" : "Cursor" } } }

3. Enregistrez le fichier. Cursor détectera et lancera automatiquement le nouveau serveur au prochain démarrage. 

Windsurf

Windsurf (Cascade) utilise mcp_config.json sous ~/.codeium/windsurf/ (ou via l'interface utilisateur de Cascade → MCP Servers) .

1. Ouvrez vos paramètres Windsurf et naviguez vers Cascade → MCP Servers, puis cliquez sur View Raw Config pour ouvrir mcp_config.json. 
2. Insérez ce qui suit sous "mcpServers" :

{ "mcpServers" : { "codeocean" : { "command" : "uvx", "args" : ["codeocean-mcp-server"], "env" : { "CODEOCEAN_DOMAIN" : "https://codeocean.acme.com", "CODEOCEAN_TOKEN" : "<YOUR_API_KEY>", "AGENT_ID" : "Windsurf" } } }

3. Sauvegardez et redémarrez Windsurf (ou appuyez sur "Refresh" dans le panneau MCP).