convez.ai
MCP Server
cBioPortal

cbioportal-navigator

cBioPortal/cbioportal-navigator

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for natural language user query -> cBioPortal URL

Instalação

$npx convez-ai cBioPortal/cbioportal-navigator

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
8
Acompanhando
0
Saúde
25%
Último commit
há 2 semanas
Versão
—
Issues abertas
13
Contribuidores
4

README

A tradução para o português deste README ainda está na fila.

cBioPortal Navigator

MCP server that helps AI assistants navigate users to the right cBioPortal pages by resolving natural language queries into structured URLs.

Overview

cBioPortal Navigator bridges natural language cancer genomics queries and cBioPortal's visualization tools. It enables AI assistants to:

  • Search and validate cancer studies, genes, and molecular profiles
  • Resolve ambiguous queries (e.g., "TCGA lung cancer" → specific study selection)
  • Build properly formatted cBioPortal URLs with complex filters and parameters
  • Navigate across StudyView, PatientView, ResultsView, and Group Comparison pages

Tools

ToolDescription
resolve_and_routeMain router — resolves studies/genes/profiles, returns metadata
get_studyviewfilter_optionsOn-demand filter metadata (clinical attributes + generic assay)
navigate_to_study_viewStudyView with filters, plots, tabs, treatments
navigate_to_patient_viewPatientView with cohort navigation
navigate_to_results_viewResultsView (OncoPrint) via session-based filtering
navigate_to_group_comparisonGroup Comparison — categorical/numerical grouping

Project Structure

cbioportal-navigator/
├── src/
│   ├── index.ts               # Entry point (stdio/HTTP mode selection, MCP server creation)
│   ├── toolRegistry.ts        # Central tool registration
│   ├── tools/
│   │   ├── resolveAndRoute.ts     # Router tool
│   │   ├── getStudyviewfilterOptions.ts
│   │   ├── navigateToStudyView.ts
│   │   ├── navigateToGroupComparison.ts
│   │   ├── navigateToResultsView.ts
│   │   ├── navigateToPatientView.ts
│   │   ├── router/                # Study/gene/profile resolvers
│   │   ├── studyView/             # URL builder, tab validator, schemas, data client
│   │   ├── groupComparison/       # Group builder, binning, session client
│   │   ├── resultsView/           # URL builder, main session client
│   │   ├── patientView/           # URL builder
│   │   └── shared/                # Config, types, API client, URL builder
│   └── prompts/                   # Prompt markdown files (copied to dist/ at build)
├── Dockerfile
├── docker-compose.mcp.yml        # Standalone MCP server
└── package.json

Usage

Option 1: Local MCP with Claude Desktop

  1. Build:

    npm install && npm run build
    
  2. Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

    {
      "mcpServers": {
        "cbioportal-navigator": {
          "command": "node",
          "args": ["/FULL/PATH/TO/cbioportal-navigator/dist/index.js"]
        }
      }
    }
    

    Important: Use absolute path. Restart Claude Desktop after changes.

  3. Restart Claude Desktop → Look for MCP connection icon

Option 2: Standalone MCP Server (Docker)

  1. Start:

    docker compose -f docker-compose.mcp.yml up -d
    
  2. Verify:

    curl http://localhost:8002/health
    
  3. Connect: MCP endpoint at http://localhost:8002/mcp

Configuration — edit docker-compose.mcp.yml:

environment:
  - MCP_TRANSPORT=http
  - PORT=8002
  - CBIOPORTAL_BASE_URL=https://www.cbioportal.org  # Change for private instance

Environment Variables

VariableDescriptionDefault
CBIOPORTAL_BASE_URLcBioPortal instance URLhttps://www.cbioportal.org
MCP_TRANSPORTTransport mode (stdio or http)stdio
PORTHTTP server port (HTTP mode only)8002

Architecture

stdio mode (default) — Claude Desktop via stdin/stdout:

Claude Desktop → MCP (stdio) → Navigator → cBioPortal API

HTTP mode — remote MCP clients:

MCP Client → /mcp (Streamable HTTP) → Navigator → cBioPortal API

HTTP endpoints: /mcp (MCP protocol), /health

Development

CommandPurpose
npm run buildCompile TS + copy prompts to dist/
npm run devRun with tsx (no build needed)
npm run watchAuto-rebuild on file changes
npm startRun compiled version

Prompts: All in src/prompts/*.md — edit and rebuild.

Resources

Ver o original no GitHub

Bom para

Relacionados