nf-core MCP Server

An MCP server for managing and navigating nf-core pipeline repositories.

Features

• List local nf-core repositories (rnaseq, sarek, modules, tools)
• Access pipeline configurations and workflows
• Search through pipeline files
• Explore pipeline modules

Installation

NPM Version

cd nf-core_mcp
npm install

# Build TypeScript
npm run build

# Start the server
npm start

Docker Version

# Build the Docker image
cd nf-core_mcp
docker build -t nf-core-mcp .
# Run the container
docker run -i --rm \
  -v "/path/to/your/workspace:/app/workspace" \
  nf-core-mcp

Adding nf-core Repositories

To add new nf-core pipeline repositories to the workspace:

1. Clone the repositories: ```bash # Navigate to your workspace directory (example for Windows) cd /path/to/your/workspace

# Clone desired nf-core repositories git clone https://github.com/nf-core/rnaseq.git git clone https://github.com/nf-core/sarek.git git clone https://github.com/nf-core/modules.git # Add any other nf-core pipeline you want to manage ```

1. Directory Structure: Your workspace should look like this: workspace/ ├── rnaseq/ ├── sarek/ ├── modules/ └── your-new-pipeline/

2. Verify Installation: After starting the MCP server, use the list-pipelines command to verify that your new pipelines are detected: list-pipelines

Note: The MCP server will automatically detect and manage any nf-core pipeline repositories in your workspace directory.

Available Tools

1. list-pipelines
2. Lists all nf-core pipelines in the workspace
3. Shows configuration file status

4. No parameters required

5. get-pipeline-modules

6. Gets module information from a pipeline

7. Parameters:

   • pipeline: Pipeline name (rnaseq, sarek, or modules)

8. search-pipelines

9. Searches through pipeline files
10. Parameters:
    • query: Search query
    • pipeline (optional): Specific pipeline to search

Available Resources

1. pipeline-config
2. Gets pipeline configuration
3. URI format: pipeline://{name}/config

4. Parameters:

   • name: Pipeline name (rnaseq, sarek, or modules)

5. pipeline-workflow

6. Gets pipeline workflow
7. URI format: pipeline://{name}/workflow
8. Parameters:
   • name: Pipeline name (rnaseq, sarek, or modules)

Usage with Cursor IDE

Using NPX (Recommended)

Add the following to your mcp.json:

{
  "mcpServers": {
    "nf-core": {
      "command": "npx",
      "args": ["-y", "nf-core-mcp"]
    }
  }
}

Using Docker

Add the following to your mcp.json:

{
  "mcpServers": {
    "nf-core": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/path/to/your/workspace:/app/workspace",
        "nf-core-mcp"
      ]
    }
  }
}

Example Usage

Using the MCP server in Cursor:

# List available pipelines
list-pipelines

# Get modules from rnaseq pipeline
get-pipeline-modules pipeline=rnaseq

# Search in all pipelines
search-pipelines query="fastqc"

# Search in specific pipeline
search-pipelines query="fastqc" pipeline=rnaseq

# Access pipeline configuration
pipeline://rnaseq/config

# Access workflow
pipeline://rnaseq/workflow

Running the Server

Using NPM

# If installed globally
nf-core-mcp

# If installed locally
npx nf-core-mcp

# Using npx without installation
npx -y nf-core-mcp

Using Docker

docker run -it --rm \
  -v /path/to/your/workspace:/app/workspace \
  nf-core-mcp

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

# Run linter
npm run lint

License

MIT