43개의 3D 및 의료 영상 데이터셋과 포인트 클라우드, 메쉬, CT/MRI 볼륨을 위한 73개의 알고리즘을 제공합니다.
다른 이름 pardesline/pardesline
- 스타
- 10
- Tools
- —
- 다운로드, 30일
- 550
- 최신 버전
- 0.5.0
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- Apache-2.0
pardesline MCP란?
43개의 3D 및 의료 영상 데이터셋과 포인트 클라우드, 메쉬, CT/MRI 볼륨을 위한 73개의 알고리즘을 제공합니다.
프로젝트 README에서 생성된 요약
pardesline MCP server 정보
3D 컴퓨터 비전 및 의료 영상을 연구하는 연구자와 개발자는 이 서버를 통해 43개의 공개 데이터셋과 73개의 알고리즘이 포함된 중앙 집중식 라이브러리에 접근할 수 있습니다. Hugging Face, Zenodo, TCIA와 같은 다양한 소스로부터 포인트 클라우드, 메쉬, CT/MRI 볼륨을 포함한 다양한 데이터 유형을 로드하는 통합된 방법을 제공합니다. 이 시스템은 매니페스트를 사용하여 단위, 레이블, 라이선스와 같은 중요한 메타데이터가 처리 과정에서 보존되고 정확히 파악되도록 합니다.
사용자는 이상적인 튜토리얼용 설정이 아닌 실제 스캔 데이터에 최적화된 기본값을 사용하여 강체 등록(rigid registration) 또는 세그멘테이션과 같은 복잡한 작업을 수행할 수 있습니다. 이 서버는 표준 Python 라이브러리와 통합되어 데이터를 Open3D, PyVista 또는 SimpleITK 형식으로 직접 변환할 수 있습니다. MCP 확장을 설치하면 AI agent가 로컬에서 이러한 데이터셋 및 알고리즘과 상호 작용하여 고급 공간 분석 및 의료 영상 작업을 수행할 수 있습니다.
활용 사례
- 1의료 스캔 등록AI agent가 강체 등록을 사용하여 CT 스캔과 MR T1 스캔을 정렬할 수 있습니다.
- 2다양한 데이터셋 로드개발자가 단일 명령으로 Hugging Face 또는 Zenodo에서 특정 의료 영상 데이터셋을 가져올 수 있습니다.
- 3비전 알고리즘 실행데이터 인지형 기본값을 사용하여 포인트 클라우드 및 메쉬에 특화된 알고리즘을 적용합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
pardesline MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 pardesline MCP 설치
$ claude mcp add --env 'HF_TOKEN=<YOUR_HF_TOKEN>' pardesline -- uvx pardeslineCursor에 pardesline MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"pardesline": {
"command": "uvx",
"args": [
"pardesline"
],
"env": {
"HF_TOKEN": "<YOUR_HF_TOKEN>"
}
}
}
}VS Code에 pardesline MCP 설치
.vscode/mcp.json
{
"servers": {
"pardesline": {
"type": "stdio",
"command": "uvx",
"args": [
"pardesline"
],
"env": {
"HF_TOKEN": "<YOUR_HF_TOKEN>"
}
}
}
}VS Code CLI에 pardesline MCP 설치
$ code --add-mcp '{"name":"pardesline","type":"stdio","command":"uvx","args":["pardesline"],"env":{"HF_TOKEN":"<YOUR_HF_TOKEN>"}}'Claude Desktop에 pardesline MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"pardesline": {
"command": "uvx",
"args": [
"pardesline"
],
"env": {
"HF_TOKEN": "<YOUR_HF_TOKEN>"
}
}
}
}Codex에 pardesline MCP 설치
$ codex mcp add pardesline --env 'HF_TOKEN=<YOUR_HF_TOKEN>' -- uvx pardeslineCodex config.toml에 pardesline MCP 설치
~/.codex/config.toml
[mcp_servers.pardesline] command = "uvx" args = ["pardesline"] [mcp_servers.pardesline.env] HF_TOKEN = "<YOUR_HF_TOKEN>"
Gemini CLI에 pardesline MCP 설치
$ gemini mcp add -s user -e 'HF_TOKEN=<YOUR_HF_TOKEN>' pardesline uvx -- pardeslineGemini settings.json에 pardesline MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"pardesline": {
"command": "uvx",
"args": [
"pardesline"
],
"env": {
"HF_TOKEN": "<YOUR_HF_TOKEN>"
}
}
}
}구성
HF_TOKEN비밀Hugging Face token, only for gated datasets whose terms you accepted (AbdomenAtlas, CT-RATE).
PARDESLINE_CACHEDownload cache (default ~/.cache/pardesline).
| 이름 | 설명 | 유형 |
|---|---|---|
| HF_TOKEN | Hugging Face token, only for gated datasets whose terms you accepted (AbdomenAtlas, CT-RATE). | 비밀 |
| PARDESLINE_CACHE | Download cache (default ~/.cache/pardesline). |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기30-second demo: dataset in, registration out
pip install "pardesline[all]"
import pardesline as pl
import pyvista as pv
s = pl.load("rire_brain")[0] # CT + MR T1 of one head (19 MB); the licence line is printed, never guessed
moved = s.ct.align(s.mr_t1) # rigid registration: SimpleITK, Mattes mutual information, catalog defaults
print(moved.transform["sub_transforms"][0]["rotation_deg"]) # [0.34, -0.35, -4.38] degrees
ct, mr = s.ct.to_pyvista(), moved.to_pyvista() # the libraries you already use, one call away
p = pv.Plotter(shape=(1, 2))
p.subplot(0, 0)
p.add_mesh(ct.slice("z"), cmap="gray")
p.add_text("CT (fixed)")
p.subplot(0, 1)
p.add_mesh(ct.slice("z"), cmap="gray")
p.add_mesh(mr.slice("z"), cmap="magma", opacity=0.55)
p.add_text("MR T1 registered onto the CT")
p.show()
Measured cold on a laptop: 7.6 s download, 8.8 s registration, 21.5 s total. The script is examples/register_ct_mr_rire/run.py.
Why this exists
- Datasets are scattered and incompatible. The Decathlon is a tar on S3, TCIA is a REST API that returns zips of DICOM, KiTS is on Hugging Face, KITTI is a zip of headerless binaries. pardesline describes each one in a manifest (files, roles, labels, frame, units, licence, citation) and fetches lazily, by HTTP Range inside archives when it can, so one sample costs one sample.
- Nothing carries its meaning. A
.binis numbers until someone says(N, 4) float32, x y z reflectance, metres. A NIfTI label map is integers until someone says1 = anterior. Manifests carry that; your own folders get it throughpl.scan, which asks what it cannot know instead of guessing. - Open3D, PyVista and SimpleITK do not talk to each other. One typed object (
PointCloud,Mesh,Volume,LabelMap) converts between them, keeps frame, units, labels, licence and provenance, and exposesto_open3d(),to_pyvista(),to_sitk()when you want the library itself. - Textbook defaults break on real scans. The ICP that converges on the tutorial fragments ends 32 degrees off on a noisy partial scan while reporting a 0.98 fitness. Every algorithm here runs behind one call with defaults tied to the data (voxel size from the bounding box, correspondence distances as multiples of it) and the sidecar records what was used. See Defaults that work on real data.
- Models do not plug into datasets. The expert skills and reference scripts (PointNet, DINOv3 features, JEPA, VAE, nnU-Net preparation) read any pardesline dataset. One-line access to pretrained models through the same manifest pattern is the next step on the roadmap.
Install
pip install pardesline # core: catalog, object model, datasets, CLI (no native libraries)
pip install "pardesline[local]" # + Open3D, PyVista, SciPy, scikit-image: point clouds, meshes, LiDAR, SDF
pip install "pardesline[medical]" # + SimpleITK: volumes, DICOM series, registration, segmentation
pip install "pardesline[hf]" # + huggingface_hub: datasets on the Hub
pip install "pardesline[mcp]" # + mcp: the local server for AI agents
pip install "pardesline[all]" # everything above
| Linux | macOS | Windows | |
|---|---|---|---|
Core (pardesline) |
3.10 – 3.13 | 3.10 – 3.13 | 3.10 – 3.13 |
[local] / [all] |
3.10 – 3.13 | 3.10 – 3.13 (arm64) | 3.10 – 3.13 |
[local] needs Open3D wheels: 0.20 covers Python 3.10 – 3.13, 0.19 covers 3.10 – 3.12. pardesline 0.2.0 on PyPI pins Open3D below 0.20, so on Python 3.13 use 3.12 or install from main until 0.3.0 ships. Conda users: conda create -n pl python=3.12 && pip install "pardesline[all]" (Open3D and SimpleITK come from PyPI). Troubleshooting: docs/running-modes.md.
📦 Datasets
One loader for every source. Files are fetched on access and verified; the licence and the citation travel with the data; ds.describe() says what each role is, in which frame and units, and what the labels mean.
ds = pl.load("totalsegmentator_ct") # 1 228 CTs, 117 structures, 23 GB zip on Zenodo: indexed with 14 MB
ct = ds.take(1)[0].ct # one 50 MB volume fetched by HTTP Range, nothing else
ds = pl.load(
"hf://neheller/KiTS-Challenge-Imaging"
) # any Hugging Face repo: a manifest is drafted and confirmed
ds = pl.load("tcia://Pancreas-CT") # any public TCIA collection: DICOM series as folders
ds = pl.scan("/data/my_study") # your folder: drafts a manifest, asks for units / labels / licence
Medical (35)
| Dataset | Modality / type | Size | Licence | Source | One-line loader |
|---|---|---|---|---|---|
| AMOS 22: abdominal multi-organ segmentation, 600 CT and MRI with 15 organ labels | CT / MRI / NIfTI (labels, volume) | 23.7 GB | CC-BY-SA-4.0 | zenodo.org | pl.load("amos22") |
| C3VD colonoscopy scenes as Gaussian splats and point clouds (EndoGSLAM fits from PR-ENDO) | endoscopy / Gaussian splats / points (points, splat) | 7.7 GB | CC-BY-4.0 | zenodo.org | pl.load("c3vd_endoscopy_splats") |
| CHAOS: abdominal CT and MR (T1 in/out-phase, T2 SPIR) as DICOM series, 40 patients | CT / MRI / DICOM (volume) | 891 MB | CC-BY-NC-SA-4.0 | zenodo.org | pl.load("chaos_abdomen") |
| AbdomenAtlas 1.0 Mini: abdominal CTs with nine organ masks (first 100 of 5 195 cases) | CT / NIfTI (labels, volume) | 7.8 GB | CC-BY-NC-SA-4.0 (gated) | Hugging Face AbdomenAtlas/AbdomenAtlas1.0Mini |
pl.load("hf_abdomenatlas_mini") |
| CVPR 2025 BiomedSegFM, 3-D validation set: 2 144 CT / MRI / PET / 3-D ultrasound / microscopy volumes as npz | CT / MRI / PET (labels, volume) | 19.5 GB | CC-BY-NC-SA-4.0 | Hugging Face junma/CVPR-BiomedSegFM |
pl.load("hf_biomedsegfm_3d_val") |
| CT-RATE: non-contrast chest CTs paired with radiology reports (first 20 validation cases) | CT / NIfTI (volume) | 6.8 GB | CC-BY-NC-SA-4.0 (gated) | Hugging Face ibrahimhamamci/CT-RATE |
pl.load("hf_ct_rate_valid") |
| KiTS23: 489 kidney-tumour CTs with kidney, tumour and cyst labels | CT / NIfTI (labels, volume) | 87.9 GB | CC-BY-NC-SA-4.0 | Hugging Face neheller/KiTS-Challenge-Imaging |
pl.load("hf_kits23") |
| NSCLC-Radiomics (TCIA) as NIfTI: 422 lung-cancer CTs with organ and tumour segmentations | CT / NIfTI (labels, volume) | 11.7 GB | CC-BY-3.0 | Hugging Face farrell236/NSCLC-Radiomics-NIFTI |
pl.load("hf_nsclc_radiomics") |
| OpenMind: head-and-neck 3D MRI pooled from OpenNeuro, one study at a time | MRI / NIfTI (labels, volume) | CC-BY-4.0 | Hugging Face MIC-DKFZ/OpenMind |
pl.load("hf_openmind") |
|
| IXI: ~600 healthy-subject brain MRIs (T1, T2, PD, MRA) from three London hospitals | MRI / NIfTI (volume) | 24.6 GB | CC-BY-SA-3.0 | biomedic.doc.ic.ac.uk | pl.load("ixi_brain_mri") |
| Liver tumour CT with three radiologists segmentations | CT (labels, volume) | 2 MB | see source | https | pl.load("liver_tumor_patient01") |
| LUNA16: 888 thoracic CTs (LIDC-IDRI subset) for lung nodule detection | CT / MetaImage (volume) | 64.8 GB | CC-BY-4.0 | zenodo.org | pl.load("luna16") |
| MedShapeNet: 106 101 anatomical and surgical-instrument shapes as STL meshes | mesh / STL (mesh) | 1953.1 GB | CC-BY-4.0 | mml.ikim.nrw | pl.load("medshapenet") |
| Medical Segmentation Decathlon, Task01 BrainTumour | MRI / NIfTI (labels, volume) | 7.4 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task01_braintumour") |
| Medical Segmentation Decathlon, Task02 Heart: left-atrium segmentation on 30 cardiac MRIs | MRI / NIfTI (labels, volume) | 456 MB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task02_heart") |
| Medical Segmentation Decathlon, Task03 Liver | CT / NIfTI (labels, volume) | 28.2 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task03_liver") |
| Medical Segmentation Decathlon, Task04 Hippocampus | MRI / NIfTI (labels, volume) | 28 MB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task04_hippocampus") |
| Medical Segmentation Decathlon, Task05 Prostate | MRI / NIfTI (labels, volume) | 240 MB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task05_prostate") |
| Medical Segmentation Decathlon, Task06 Lung | CT / NIfTI (labels, volume) | 8.9 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task06_lung") |
| Medical Segmentation Decathlon, Task07 Pancreas | CT / NIfTI (labels, volume) | 12.0 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task07_pancreas") |
| Medical Segmentation Decathlon, Task08 HepaticVessel | CT / NIfTI (labels, volume) | 9.1 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task08_hepaticvessel") |
| Medical Segmentation Decathlon, Task09 Spleen | CT / NIfTI (labels, volume) | 1.6 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task09_spleen") |
| Medical Segmentation Decathlon, Task10 Colon | CT / NIfTI (labels, volume) | 6.1 GB | CC-BY-SA-4.0 | msd-for-monai.s3-us-west-2.amazonaws.com | pl.load("msd_task10_colon") |
| OpenNeuro ds000228: T1-weighted MRI of 155 children and adults (Richardson et al.) | MRI / NIfTI (volume) | 2.4 GB | PDDL-1.0 | S3 openneuro.org |
pl.load("openneuro_ds000228") |
| POPI-model: 4D-CT of one thorax, six breathing phases | CT / 4D (labels, volume) | 500 MB | see source | creatis.insa-lyon.fr | pl.load("popi_lung_4dct") |
| RIRE training_001: CT and MR-T1 of one brain | CT / MRI (volume) | 19 MB | see source | rire.insight-journal.org | pl.load("rire_brain") |
| SPIDER: lumbar spine MRI (T1, T2, T2 SPACE) of 218 patients with vertebra, disc and canal masks | MRI / MetaImage (labels, volume) | 3.7 GB | CC-BY-4.0 | zenodo.org | pl.load("spider_lumbar_mri") |
| TCIA LIDC-IDRI: 1 018 thoracic CTs for lung nodule analysis (DICOM) | DICOM / CT (volume) | 122.1 GB | CC-BY-3.0 | TCIA LIDC-IDRI |
pl.load("tcia_lidc_idri") |
| TCIA NSCLC-Radiomics: 422 lung-cancer CTs with RTSTRUCT and SEG contours (DICOM) | DICOM / CT (volume) | 32.2 GB | CC-BY-3.0 | TCIA NSCLC-Radiomics |
pl.load("tcia_nsclc_radiomics_dicom") |
| TCIA Pancreas-CT: 82 abdominal contrast-enhanced CTs (NIH) | DICOM / CT (volume) | 8.8 GB | CC-BY-3.0 | TCIA Pancreas-CT |
pl.load("tcia_pancreas_ct") |
| TCIA Prostate-3T: 64 T2-weighted prostate MRIs (DICOM) | DICOM / MRI (volume) | 200 MB | CC-BY-3.0 | TCIA Prostate-3T |
pl.load("tcia_prostate_3t") |
| TotalSegmentator CT dataset v2.0.1: 1 228 CT volumes with 117 anatomical structures | CT / NIfTI (labels, volume) | 23.0 GB | CC-BY-4.0 | zenodo.org | pl.load("totalsegmentator_ct") |
| TotalSegmentator MRI dataset v1.0.0: 298 MRI volumes with 56 anatomical structures | MRI / NIfTI (labels, volume) | 2.3 GB | CC-BY-NC-SA-2.0 | zenodo.org | pl.load("totalsegmentator_mri") |
| VerSe 2019: 160 spine CTs with vertebra-level label maps and centroids | CT / NIfTI (labels, volume) | 12.0 GB | CC-BY-SA-4.0 | s3.bonescreen.de | pl.load("verse19_spine") |
| Visible Human Project: MRI of the head | MRI (volume) | 2 MB | see source | nlm.nih.gov | pl.load("visible_human_head_mri") |
General 3D (8)
| Dataset | Modality / type | Size | Licence | Source | One-line loader |
|---|---|---|---|---|---|
| 3D Arena: image-to-3D outputs of 29 generators on 100 shared input images | mesh / Gaussian splats (image, mesh, splat) | 19.5 GB | MIT | Hugging Face 3d-arena/3d-arena |
pl.load("hf_3d_arena") |
| KITTI-360 street chunks as point clouds and Gaussian splats (GaussianWorld subset, 16 chunks) | LiDAR / points / Gaussian splats (points) | 2.4 GB | CC-BY-NC-SA-3.0 | Hugging Face GaussianWorld/kitti_360_subset_chunk_gs_preprocessed |
pl.load("hf_kitti360_gs_subset") |
| Objaverse 1.0, one shard of glTF meshes (5 000 objects) | mesh (mesh) | 14.6 GB | ODC-By-1.0 | Hugging Face allenai/objaverse |
pl.load("hf_objaverse_glb_shard") |
| UniOcc, CARLA 10 Hz mini split: LiDAR sweeps, camera views and semantic occupancy grids | LiDAR / points (image, labels, points) | 4.9 GB | MIT | Hugging Face tasl-lab/uniocc |
pl.load("hf_uniocc_carla_mini") |
| KITTI raw, drive 2011_09_26_0001: 108 Velodyne sweeps with the four camera streams | LiDAR / points / stereo (image, points) | 459 MB | CC-BY-NC-SA-3.0 | s3.eu-central-1.amazonaws.com | pl.load("kitti_raw_2011_09_26_drive_0001") |
| Stanford armadillo (Open3D demo mesh) | mesh (mesh) | 7 MB | see source | Open3D data | pl.load("open3d_armadillo") |
| Stanford bunny (Open3D demo mesh) | mesh (mesh) | 3 MB | see source | Open3D data | pl.load("open3d_bunny") |
| Open3D ICP demo: three indoor point-cloud fragments | points (points) | 6 MB | see source | Open3D data | pl.load("open3d_icp_demo") |
"Size" is the whole source; one sample costs its own size. "See source" means the data owner states terms outside a standard licence; ds.describe() prints them and the loader warns. Not bundled, and why: BraTS (Synapse data-use agreement), ModelNet, ShapeNet and ScanNet (registration-gated downloads); they are on the Datasets wanted list.
What standardization and the manifest give you: every role is typed (volume, labels, mesh, points, splat, image, transform), with frame (LPS, sensor, Y-up), units (mm, m), label names, raw-array layouts, licence, citation and provenance; label maps become exact surfaces in world coordinates, DICOM series become one volume, .npy/.bin become point clouds; ds.export(folder) writes standard PLY / MetaImage files with sidecars; ds.split(by="patient") never leaks a patient across splits. Add a dataset: CONTRIBUTING.md and docs/datasets.md.
pardesline MCP 질문
pardesline MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'HF_TOKEN=<YOUR_HF_TOKEN>' pardesline -- uvx pardesline를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
pardesline MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
pardesline은 어떤 종류의 데이터를 지원하나요?
포인트 클라우드, 메쉬, CT/MRI 볼륨을 포함한 3D 컴퓨터 비전 및 의료 영상 데이터를 지원합니다.
AI agent와 함께 pardesline을 어떻게 사용할 수 있나요?
패키지에 포함된 MCP 도구를 사용하여 AI agent에게 결과를 전달할 수 있습니다.