본문으로 건너뛰기
cccskills
무료GitHub에 공개

mcp-jupyter

Reference for MCP Jupyter tools (kernel management, cell execution, Papermill). Use when executing notebooks, managing kernels, or running code interactively via MCP.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md3.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

MCP Jupyter Reference

When to Use MCP vs Local Scripts

NeedToolWhy
Batch validation (Python)scripts/notebook_tools/notebook_tools.py validateFaster, no kernel setup
Batch execution (Python)scripts/notebook_tools/notebook_tools.py executePapermill CLI, simpler
Structure analysisscripts/notebook_tools/notebook_helpers.py list --verboseLocal, instant
Find enrichment gapsNotebookHelper.find_cells_needing_enrichment()Python API
Cell-by-cell .NET executionMCP execute_on_kernelOnly option (Papermill blocked)
Interactive debuggingMCP manage_kernel + execute_on_kernelLive kernel state
Notebook read/write via APIMCP read_cells, add_cellRemote/programmatic

Rule: Prefer local scripts for Python notebooks. Use MCP for .NET kernels and interactive sessions. See notebook-helpers skill for full script reference.

Available MCP Tools

ToolDescription
list_kernels()List available kernel specs
manage_kernel(action, kernel_name/id)start/stop/restart/interrupt kernel
execute_on_kernel(kernel_id, mode, ...)Execute code, cell, or full notebook
execute_notebook(input_path, ...)Papermill execution (sync/async)
read_notebook(path)Read notebook content
read_cells(path, mode)Read cells (list/summary)
get_notebook_info(path)Notebook metadata
manage_async_job(action, job_id)Manage async Papermill jobs

Supported Kernels

KernelNameNotes
Python 3python3Via ipykernel in conda mcp-jupyter-py310
.NET C#.net-csharpVia dotnet-interactive
.NET F#.net-fsharpVia dotnet-interactive
Lean 4lean4Via WSL wrapper

Execution Patterns

Python notebooks - Papermill (preferred for batch)

execute_notebook(
    input_path="MyIA.AI.Notebooks/path/notebook.ipynb",
    output_path="MyIA.AI.Notebooks/path/notebook.ipynb",  # Same file = overwrite with outputs
    mode="sync"
)

Python notebooks - Cell-by-cell (for control)

manage_kernel(action="start", kernel_name="python3")
# Execute cells
execute_on_kernel(kernel_id="...", mode="notebook_cell", path="notebook.ipynb", cell_index=0)
# ...
manage_kernel(action="stop", kernel_id="...")

.NET notebooks - Cell-by-cell ONLY

IMPORTANT: Papermill does NOT work with .NET notebooks. Always use cell-by-cell.

manage_kernel(action="start", kernel_name=".net-csharp")

# CRITICAL: Set working directory first
execute_on_kernel(
    kernel_id="...", mode="code",
    code='System.IO.Directory.SetCurrentDirectory(@"d:\\dev\\CoursIA\\MyIA.AI.Notebooks\\Sudoku");'
)

# Execute cells sequentially
for idx in range(cell_count):
    execute_on_kernel(kernel_id="...", mode="notebook_cell", path="notebook.ipynb", cell_index=idx)

manage_kernel(action="stop", kernel_id="...")

Known Issues

ProblemWorkaround
Papermill + #!importUse cell-by-cell execution
Papermill + .NET kernelsKernel hangs at startup; use cell-by-cell
.NET cold start timeoutNormal (30-60s); retry once
Async progress values incorrectKnown bug; ignore progress numbers
Kernel unresponsive after failed PapermillStop and restart kernel
Relative paths failSet working directory explicitly
Widgets/interactive elementsUse BATCH_MODE=true parameter

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Cycle 30 min du secrétaire vérificateur myia-po-2028:CoursIA-3. Atteste en tiers, du plus ancien au plus récent, les PRs ouvertes sans dossier valide (chaque READY, une fois lu et approuvé par ai-01, est mergé sans attendre son cycle), et fait circuler l'information sur workspace-CoursIA-3.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

jsboige/CoursIA162026년 10월 22일 업데이트

Analyze a Slidev deck qualitatively — organ reports (structure, composition) + vision AI on rendered PNGs. Arguments: <deck_id> [--slides 1,5,10]

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

jsboige/CoursIA162026년 10월 22일 업데이트

Build or improve Jupyter notebooks iteratively with quality scoring. Arguments: <new|improve|fix> <path> [--topic] [--domain] [--level] [--quality] [--max-iter]

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

jsboige/CoursIA162026년 10월 22일 업데이트

Detect cell-ordering / enchainement problems in Jupyter notebooks (canonical-order slippage, misplaced or forgotten cells). Arguments: [target] [--severity HIGH|MED|LOW] [--json]

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

jsboige/CoursIA162026년 10월 22일 업데이트

Clean up and reorganize markdown in enriched Jupyter notebooks. Arguments: [target] [--dry-run] [--aggressive] [--hierarchy-only]

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

jsboige/CoursIA162026년 10월 22일 업데이트

Cycle de coordination ai-01 (coordinateur UNIQUEMENT — jamais sur un worker). Lit memoire + dashboards + inbox + GitHub, merge les PRs pretes, tranche les design-gates, dispatche des grains par lane, reporte. Arguments: [--dispatch] [--focus <topic>]

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

jsboige/CoursIA162026년 10월 22일 업데이트

jsboige의 스킬 모두 보기

이 스킬의 문제 신고