# pardesline

> pardesline is an open-source MCP server for health and science. Python 3D vision and medical imaging datasets and algorithms, served to agents over MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, macOS, Windows, CLI
- **Website:** https://pardesline.github.io/pardesline/latest/mcp/
- **Repository:** https://github.com/pardesline/pardesline
- **MCP Registry name:** io.github.pardesline/pardesline
- **Categories:** health and science, developer tools
- **Listing updated:** 2026-11-14

## About

pardesline is a Python package that loads public 3D and medical datasets and runs algorithms on point clouds, meshes and CT or MRI volumes. Its MCP server runs on your machine without an account and exposes the same catalogue: 43 datasets and 73 algorithms, through fourteen tools, five resources and a start_here prompt.

When the package cannot know something, such as a licence, units or array layout, it returns the question as JSON for the agent to pass to you instead of guessing. Datasets are described in manifests that carry files, labels, frame, units, licence and citation. Twenty bundled skills, including registration, PointNet segmentation, Gaussian splatting and atlas label transfer, are served through list_skills and get_skill.

Install with pip install "pardesline[mcp]" and start it with pardesline mcp over stdio or streamable HTTP. A Docker image and a uvx recipe are also documented.

## Features

- **43 datasets:** Public 3D and medical datasets described with licences and citations.
- **73 algorithms:** Registration, segmentation and other methods with defaults tied to the data.
- **Questions returned as JSON:** Licence, units and layout questions go back to the human instead of being guessed.
- **Expert skills:** Twenty skills with reference scripts are served to any MCP client.
- **Private folder scanning:** Scan your own data with scan_dataset and confirm_dataset.
- **Several launch options:** Run over stdio, streamable HTTP, uvx or Docker.

## Good for

- Register a CT and MR scan pair
- Browse a medical dataset and read its licence
- Run a point-cloud registration method on a sample
- Convert a volume to a mesh
- Get an agent to follow an expert registration or segmentation guide

## Install

### Claude Code (Terminal)

```sh
claude mcp add pardesline --env HF_TOKEN='<HF_TOKEN>' -- uvx pardesline
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pardesline": {
      "command": "uvx",
      "args": [
        "pardesline"
      ],
      "env": {
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pardesline": {
      "command": "uvx",
      "args": [
        "pardesline"
      ],
      "env": {
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pardesline": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pardesline"
      ],
      "env": {
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pardesline": {
      "command": "uvx",
      "args": [
        "pardesline"
      ],
      "env": {
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pardesline": {
      "command": "uvx",
      "args": [
        "pardesline"
      ],
      "env": {
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_datasets`: List available datasets.
- `describe_dataset`: Describe one dataset.
- `list_samples`: List samples in a dataset.
- `load_sample`: Load a sample.
- `scan_dataset`: Scan a private folder into a dataset.
- `confirm_dataset`: Confirm a scanned dataset.
- `export_dataset`: Export a dataset.
- `list_methods`: List algorithms.
- `describe_method`: Describe an algorithm.
- `run_method`: Run an algorithm.
- `describe_object`: Describe a loaded object.
- `to_mesh`: Convert an object to a mesh.
- `list_skills`: List bundled expert skills.
- `get_skill`: Fetch one skill.

## FAQ

### Does it need an account?

No. The MCP server runs on your machine without an account.

### Which clients are documented?

Claude Code, Claude Desktop, Cursor, Gemini CLI and Codex CLI.

### Are gated datasets supported?

Yes, with a Hugging Face token for gated sets whose terms you accepted, such as AbdomenAtlas and CT-RATE.

### How many tools does it expose?

Fourteen tools, five resources and a start_here prompt.

### Is pardesline free?

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

### How do I add pardesline to Claude Code?

Run this command in your terminal: claude mcp add pardesline --env HF_TOKEN='<HF_TOKEN>' -- uvx pardesline

### What are the best alternatives to pardesline?

The closest alternatives to pardesline are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.

---
Source: https://ai-powered.com/mcp/pardesline
