Notebook MCP Server

v0.1.0

Jupyter 노트북(.ipynb) 파일을 편집할 수 있는 MCP(Model Context Protocol) 서버입니다.

설치

git clone https://github.com/CuriousN006/notebook-mcp-server.git
cd notebook-mcp-server
pip install -e .

또는 uv 사용 시:

cd notebook-mcp-server
uv pip install -e .

사용법

직접 실행

python -m notebook_mcp.server

Antigravity/VS Code에 등록

MCP 설정 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "notebook-editor": {
      "command": "python",
      "args": ["-m", "notebook_mcp.server"],
      "env": {
        "PYTHONPATH": "/path/to/notebook-mcp-server/src"
      }
    }
  }
}

제공 도구

💡 이미지 출력 지원: read_cell_output은 matplotlib 그래프 등 이미지 출력을 MCP ImageContent로 반환합니다. LLM이 그래프를 직접 보고 분석할 수 있습니다! (지원 형식: PNG, JPEG, GIF, WebP)

AI 시스템 프롬프트 (권장)

AI 어시스턴트가 이 MCP 서버를 올바르게 사용하도록 다음 내용을 시스템 프롬프트에 추가하세요:

- .ipynb 형식 노트북 파일은 `notebook-editor` MCP 서버를 통해 직접 수정합니다.
  - 노트북 경로는 반드시 절대 경로로 지정하세요 (예: `/path/to/notebook.ipynb`)
  - ⚠️ **주의사항**: 노트북 수정 전에 VS Code에서 해당 파일이 **저장된 상태**인지 확인하세요.
    - 셀 실행 후 저장하지 않은 상태에서 MCP로 수정하면, VS Code가 덮어써서 수정이 유실될 수 있습니다.
    - 수정 요청 시 사용자에게 "파일을 저장(Ctrl+S)했는지" 먼저 확인해주세요.

라이선스

MIT