Skip to content

The MCP server for AI agents

pardesline mcp exposes the datasets, the object model and the 73 algorithms to any Model Context Protocol client, on the user's machine, without an account. Twelve tools (list_datasets, describe_dataset, list_samples, load_sample, scan_dataset, confirm_dataset, export_dataset, list_methods, describe_method, run_method, describe_object, to_mesh), three resources and a start_here prompt. Questions the package will not guess (licence, units, array layout) come back as JSON for the agent to relay to the human.

pip install "pardesline[mcp]"
pardesline mcp                                            # stdio
pardesline mcp --transport streamable-http --port 8765    # http://127.0.0.1:8765/mcp
Client Configuration
Claude Code claude mcp add pardesline -- pardesline mcp (the repo ships a .mcp.json)
Claude Desktop, Cursor "mcpServers": {"pardesline": {"command": "pardesline", "args": ["mcp"]}}
Gemini CLI the same block in ~/.gemini/settings.json
Codex CLI [mcp_servers.pardesline] command = "pardesline" args = ["mcp"] in ~/.codex/config.toml

If pardesline is not on your PATH, the command is python -m pardesline.mcp_server.

The skills/ folder holds twenty skills, grounded in the code and checked by the test suite (every module, method, parameter and dataset they mention must exist). Nine teach the package: using-pardesline (start here), catalog-and-run, object-model, datasets-and-manifests, scanning-private-folders, medical-volumes, cloud-client, mcp-server, contributing-algorithms. Eleven are expert guides with reference scripts for the domains the package serves, written for engineers who build the pipelines, and served to any MCP client through list_skills / get_skill:

Skill What it carries Runnable script
3d-representations points vs meshes vs voxels vs splats: memory, architectures, the conversion matrix and its pitfalls -
point-cloud-registration RANSAC + FPFH + ICP, every parameter from one voxel size, metrics that lie, CPD registration_eval.py (pose error on a known transform)
multimodal-rigid-registration CT/MR with Mattes MI in SimpleITK: initialiser, optimizer scales, pyramid, validation by TRE rigid_ct_mr.py (RIRE pair, metric trace, checkerboard)
atlas-label-transfer labelled atlas -> unlabelled scan: registration, nearest-structure labels, per-label surfaces and volumes atlas_label_transfer.py (99 % label agreement on a synthetic scan)
pointnet-segmentation PointNet / PointNet++ step by step, data contract, training recipe make_point_dataset.py (label maps -> labelled clouds), pointnet_seg.py (PyTorch)
dinov3-dense-features Gram anchoring, frozen backbones, ViTDet pyramid + Faster R-CNN, medical transfer limits dinov3_features.py, dinov3_faster_rcnn.py
jepa-pretraining latent prediction instead of reconstruction, 3-D tokenisation, masking, collapse diagnostics jepa3d_pretrain.py (3-D ViT, EMA target, block masks)
vae-anomaly-detection normal-only training, residual maps, thresholds, honest limits vae_anomaly.py (train / score / AUROC)
gaussian-splatting the primitive, the five-step initialisation, PLY layout, training, medical uses points_to_gaussians.py (any cloud -> 3DGS PLY)
medical-segmentation-models nnU-Net, TotalSegmentator, transformers, preprocessing, inference, evaluation prepare_nnunet_dataset.py (any dataset -> nnU-Net raw)
evaluation-metrics-3d Dice / HD95 / NSD, chamfer / F-score, TRE, folding, AP, AUROC, PSNR, and how to report them metrics3d.py

Install them as a plugin (it also registers the MCP server):

/plugin marketplace add pardesline/pardesline
/plugin install pardesline@pardesline