Code Ocean

Provides tools to search and run capsules and pipelines, and manage data assets.

typescript

3

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "codeocean-codeocean-mcp-server": {
      "command": "uvx",
      "args": [
        "codeocean-mcp-server"
      ],
      "env": {
        "AGENT_ID": "VS Code",
        "CODEOCEAN_TOKEN": "${input:codeocean-token}",
        "CODEOCEAN_DOMAIN": "https://codeocean.acme.com"
      }
    }
  }
}

You have access to a Code Ocean MCP Server that lets you search and run capsules and pipelines, and manage data assets through the MCP protocol. This server enables easy integration with your Code Ocean environment and partner tooling, so you can orchestrate tasks from your preferred MCP client.

How to use

You connect to the Code Ocean MCP Server from an MCP client using a stdio (local) transport. The MCP server runs as a local process started by the client interface, and it exposes the Code Ocean tools you need to search, run capsules, pipelines, and manage assets. In your MCP client, pick the Code Ocean MCP Server configuration and ensure your client provides your Code Ocean API token and domain so the server can authenticate requests.

Typical usage patterns include starting the MCP server process from your editor or tool, authenticating with your Code Ocean token, and then invoking tools to explore capsules, run pipelines, or manage data assets. You can observe the server logs and responses in your client’s MCP panel to verify tool availability and execution results.

How to install

Prerequisites you need before installing the MCP server are as follows.

Install the runtime required to host the MCP server: you should have uv and a supported runtime available. You also need a Code Ocean access token to authenticate with the Code Ocean platform.

Then configure your client to run the MCP server with the provided command and environment variables.

{
  "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"
        }
      }
    },
  }
}

Local testing

Test the MCP server locally during development with MCP Inspector. This starts a web server to view available tools, test tool calls, and inspect server logs.

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

Available tools

searchCapsules

Search available Code Ocean capsules and pipelines to identify suitable execution targets.

runCapsules

Execute selected capsules or pipelines and manage execution context.

manageAssets

Interact with Code Ocean data assets, including import/export and lifecycle operations.