Code Ocean MCP Server

Busca y ejecuta cápsulas, ejecuta pipelines y gestiona activos de datos en la plataforma Code Ocean.

GitHub
5
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Code Ocean

Servidor de Protocolo de Contexto de Modelo (MCP) para Code Ocean.

Este servidor MCP proporciona herramientas para buscar, ejecutar y publicar cápsulas y pipelines, y gestionar activos de datos.

Tabla de Contenidos

Prerrequisitos

  1. Instale uv desde Astral o el README de GitHub
  2. Instale Python 3.10 o más reciente usando uv python install 3.10 (o una versión más reciente)
  3. Genere un token de acceso de Code Ocean. Siga las instrucciones en la guía de usuario de Code Ocean.

Compatibilidad de Versiones de la Plataforma Code Ocean

Cada versión de este Servidor MCP de Code Ocean se prueba y verifica contra una versión mínima específica de la API de la plataforma Code Ocean. Generalmente, esta versión mínima es la versión más reciente de Code Ocean en el momento de la publicación del Servidor MCP. Recomendamos asegurarse de que su dependencia del Servidor MCP esté fijada a una versión compatible con su implementación de Code Ocean. Para detalles sobre cuándo cambia la versión mínima de la plataforma Code Ocean, consulte el CHANGELOG.

Instalación

Visual Studio Code

Aquí hay un ejemplo de configuración del servidor MCP en 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"
                }
            }
        },
    }
}

Claude Desktop

  1. Abra el archivo claude_desktop_config.json:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  1. Bajo el objeto de nivel superior "mcpServers", agregue una entrada "codeocean". Para un transporte stdio (proceso hijo) se ve así:
{
  "mcpServers": {
    "codeocean": {
      "command": "uvx",
      "args": ["codeocean-mcp-server"],
      "env": {
        "CODEOCEAN_DOMAIN": "https://codeocean.acme.com",
        "CODEOCEAN_TOKEN": "<YOUR_API_KEY>",
        "AGENT_ID": "Claude Desktop"
      }
    }
  }
}

Cline

Cline almacena toda su configuración de MCP en un archivo JSON llamado cline_mcp_settings.json. Puede editarlo ya sea a través de la GUI ("Configurar Servidores MCP" en el panel de Servidores MCP) o manualmente:

  1. Abra Cline y haga clic en el ícono de Servidores MCP en la barra lateral.
  2. En la pestaña "Instalados", haga clic en Configurar Servidores MCP → esto abre su cline_mcp_settings.json.
  3. Agregue un servidor "codeocean" bajo la clave "mcpServers". Para transporte 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
    }
  }
}
  1. Guarde el archivo. Cline detectará y lanzará automáticamente el nuevo servidor, haciendo que sus herramientas de Code Ocean estén disponibles en el chat.

Roo Code

El soporte MCP de Roo Code se configura globalmente en todos los espacios de trabajo a través de un archivo de configuración JSON o mediante su interfaz dedicada de Configuración MCP

A través de la interfaz de Configuración MCP:

  1. Haga clic en el ícono MCP en la barra lateral de Roo Code.
  2. Seleccione Editar Configuración MCP (abre cline_mcp_settings.json).
  3. Bajo "mcpServers", agregue:
{
  "mcpServers": {
    "codeocean": {
      "command": "uvx",
      "args": ["codeocean-mcp-server"],
      "env": {
        "CODEOCEAN_DOMAIN": "https://codeocean.acme.com",
        "CODEOCEAN_TOKEN": "<YOUR_API_KEY>",
        "AGENT_ID": "Roo Code"
      }
    }
  }
}
  1. Guarde y reinicie Roo Code; sus herramientas de Code Ocean aparecerán automáticamente.

Opcional: Editar manualmente cline_mcp_settings.json

  1. Localice cline_mcp_settings.json (en su directorio de inicio o espacio de trabajo).
  2. Inserte el mismo bloque "codeocean" bajo "mcpServers" como arriba.
  3. Guarde y reinicie.

Cursor

Cursor almacena los servidores MCP en un archivo JSON en ~/.cursor/mcp.json (global) o {proyecto}/.cursor/mcp.json (específico del proyecto).

  1. Abra .cursor/mcp.json (o créelo si no existe).
  2. Agregue bajo "mcpServers":
{
  "mcpServers": {
    "codeocean": {
      "command": "uvx",
      "args": ["codeocean-mcp-server"],
      "env": {
        "CODEOCEAN_DOMAIN": "https://codeocean.acme.com",
        "CODEOCEAN_TOKEN": "<YOUR_API_KEY>",
        "AGENT_ID": "Cursor"
      }
    }
  }
}
  1. Guarde el archivo. Cursor detectará y lanzará automáticamente el nuevo servidor en el próximo inicio.

Windsurf

Windsurf (Cascade) usa mcp_config.json bajo ~/.codeium/windsurf/ (o a través de la interfaz Cascade → Servidores MCP).

  1. Abra su Configuración de Windsurf y navegue a Cascade → Servidores MCP, luego haga clic en Ver Configuración Cruda para abrir mcp_config.json.
  2. Inserte lo siguiente bajo "mcpServers":
{
  "mcpServers": {
    "codeocean": {
      "command": "uvx",
      "args": ["codeocean-mcp-server"],
      "env": {
        "CODEOCEAN_DOMAIN": "https://codeocean.acme.com",
        "CODEOCEAN_TOKEN": "<YOUR_API_KEY>",
        "AGENT_ID": "Windsurf"
      }
    }
  }
}
  1. Guarde y reinicie Windsurf (o presione "Actualizar" en el panel MCP).

Transporte HTTP Transmisible

Por defecto, el servidor se ejecuta sobre stdio y se autentica con la variable de entorno CODEOCEAN_TOKEN, como se describió anteriormente. También puede atender a múltiples usuarios desde un solo proceso sobre HTTP transmisible, tomando el token de API de cada llamador desde la solicitud:

CODEOCEAN_DOMAIN=https://acmecorp.codeocean.com codeocean-mcp-server --transport streamable-http --host 127.0.0.1 --port 8000

Los clientes entonces pasan su propio token como Authorization: Bearer <YOUR_API_KEY> en cada solicitud; CODEOCEAN_TOKEN no se usa, y una solicitud sin token es rechazada. El endpoint es http://<host>:<port>/mcp.

Pruebas Locales

Puede probar el servidor MCP localmente durante el desarrollo con MCP Inspector:

npx @modelcontextprotocol/inspector uv tool run codeocean-mcp-server

Esto iniciará un servidor web donde puede:

  • Ver herramientas y recursos disponibles
  • Probar llamadas de herramientas interactivamente
  • Ver registros y respuestas del servidor

Formato de Registros (Opcional)

El servidor MCP admite formato de registros personalizado a través de la variable de entorno LOG_FORMAT. Esto le permite controlar el formato de los mensajes de registro generados por el servidor. Ejemplos de Cadenas de Formato: "%(asctime)s %(levelname)s [%(name)s] %(message)s". Si LOG_FORMAT no está configurado, el servidor usa la configuración de registro predeterminada de FastMCP.

La variable de entorno LOG_LEVEL establece el nivel en el que el servidor registra: DEBUG, INFO (el predeterminado), WARNING, ERROR o CRITICAL. Elevarlo elimina el registro que el servidor escribe para cada solicitud que atiende, lo cual vale la pena hacer cuando el servidor se ejecuta junto a un llamador que registra esas solicitudes por sí mismo.