Skip to content
MCP server

Neuro MCP

MCP server giving AI agents 54 tools for EEG processing, EHR records and visualization

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.4
Listing updated
2 days ago

About Neuro MCP

Neuro MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

Neuro-mcp is built for agents that help clinicians and researchers work with EEG data. A FastMCP server named neuro-analysis exposes 54 tools across five areas, so one agent can move from loading a recording to filtering, epoching and spectral analysis without leaving the same interface.

Processing tools work on an in-memory state keyed by a session id: load a recording once, then chain filter, ICA, epoch and spectral calls against it. Source imaging tools run on MNE-Python. A separate store keeps datasets, subjects, EHR records and annotations in SQLite by default or Postgres for production, with recordings laid out in BIDS on disk.

Clinical records are versioned and never overwritten or hard-deleted. An amendment adds a new version and keeps the prior one, a void marks a record entered-in-error, and every change is written to an audit log with actor, action and before and after values. Mutating tools take an explicit actor; the docs say auth and role enforcement are planned for v0.2. The NeuroII web visualization link is optional and returns a structured not-configured response when no endpoint is set.

Install

Run in a terminal

claude mcp add neuro-mcp -- uvx neuro-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "neuro-mcp": {
      "command": "uvx",
      "args": [
        "neuro-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "neuro-mcp": {
      "command": "uvx",
      "args": [
        "neuro-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "neuro-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "neuro-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "neuro-mcp": {
      "command": "uvx",
      "args": [
        "neuro-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "neuro-mcp": {
      "command": "uvx",
      "args": [
        "neuro-mcp"
      ]
    }
  }
}

Tools this server provides (32)

Taken from the project documentation; the running server may differ.

load_neuro
Load a neuro recording into a session
filter_neuro
Filter a recording
resample_neuro
Resample a recording
set_montage
Set the electrode montage
set_reference
Set the reference
detect_bad_channels
Detect bad channels
run_ica
Run ICA
apply_ica
Apply ICA
find_events
Find events
epoch_neuro
Epoch a recording
compute_psd
Compute power spectral density
compute_erp
Compute event-related potentials
time_frequency
Time-frequency analysis
register_subject
Register a subject
get_subject
Get a subject
add_ehr_record
Add an EHR record
amend_ehr_record
Amend an EHR record as a new version
get_ehr_history
Get EHR history
void_ehr_record
Mark an EHR record entered-in-error
import_recording
Import a recording to BIDS
register_dataset
Register a dataset
query_datasets
Query datasets
list_recordings
List recordings
add_annotation
Add an annotation
update_annotation
Update an annotation as a new version
list_annotations
List annotations
void_annotation
Void an annotation
get_audit_log
Read the audit log
neuroii_push_recording
Push a recording to NeuroII
neuroii_create_viz_session
Create a NeuroII visualization session
neuroii_pull_annotations
Pull annotations from NeuroII
visualize_timeseries
Interactive stacked multichannel EEG view

What it does

EEG processing chain
Load, filter, resample, re-reference, run ICA, epoch and compute PSD, ERP and time-frequency results in one session.
Source imaging
Tools from fetching a template head to extracting label time courses support ESI workflows.
Versioned EHR records
Amending creates a new version and voiding sets entered-in-error, so history is preserved.
Audit log
Each mutation is recorded with actor, action and before and after values.
Dataset and BIDS store
Register and query datasets and import recordings into a BIDS tree.
Interactive visualizations
Produce standalone Plotly HTML views such as stacked multichannel EEG with annotation markers.

Good for

  • Review an EEG recording and add annotations through an agent
  • Correct an EHR value while keeping the original and its author
  • Run a preprocessing and spectral analysis pipeline on a dataset
  • Run source imaging on a recording
  • Push a recording to a NeuroII visualization session

Pricing

Open source

Prices change. Check aimplifier.github.io before you buy.

Neuro MCP FAQ

How do I install it?

It is published on PyPI as neuro-mcp (version 0.1.4 in the registry) and runs over stdio.

Which database does it use?

SQLite by default, and Postgres for production, plus a BIDS recording tree on disk.

Can records be deleted?

No. Records are versioned and voiding only marks them entered-in-error; history stays.

Is access control enforced?

Not yet. The docs say auth and RBAC enforcement is planned for v0.2.

Is Neuro MCP free?

Yes. Neuro MCP is open source, so you can use and self-host it for free.

How do I add Neuro MCP to Claude Code?

Run this command in your terminal: claude mcp add neuro-mcp -- uvx neuro-mcp

What are the best alternatives to Neuro MCP?

The closest alternatives to Neuro MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to Neuro MCP

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science