Notion 지식 기반 MCP 서버

Cline VSCode 확장을 통해 Notion 지식 기반에 대한 액세스를 제공하는 MCP 서버입니다.

특징

Cline에서 직접 Notion 지식 기반을 쿼리하세요
Notion 페이지를 참조하여 자세한 답변을 얻으세요
안정적인 성능을 위해 FastMCP로 구축됨
포괄적인 오류 처리 및 로깅

Related MCP server: Memory Box MCP Server

필수 조건

Python 3.10 이상
uv 패키지 관리자
클라인 VSCode 확장
Notion 지식 기반에 액세스하기 위한 Dify API 키

설치

이 저장소를 복제하세요:
지엑스피1
Dify API 키로 .env 파일을 만듭니다.
echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env
Cline에 서버를 설치하세요:
fastmcp install notion_mcp_server.py
이렇게 하면 자동으로 다음이 수행됩니다.
- uv를 사용하여 필요한 모든 종속성을 설치합니다.
- Cline의 설정에서 서버를 구성하세요
- Cline과 함께 사용할 수 있는 서버를 만드세요

용법

설치가 완료되면 Cline에서 Notion 지식 베이스에 대한 질문을 통해 서버를 사용할 수 있습니다. 예:

Tell me about internal tooling

서버는 다음을 포함하여 Notion 지식 기반에서 관련 정보로 응답합니다.

자세한 답변
관련 Notion 페이지 링크
참조용 페이지 ID

구성

서버는 설치 중에 자동으로 구성되지만 필요한 경우 Cline의 구성 파일에서 설정을 수동으로 업데이트할 수 있습니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

구성 예:

{ "mcpServers": { "notion-kb": { "command": "uv", "args": [ "run", "--with", "fastmcp", "--with", "python-dotenv", "--with", "requests", "fastmcp", "run", "/absolute/path/to/notion_mcp_server.py" ], "env": { "DIFY_API_BACKEND_KEY": "your-api-key" } } } }

개발

개발 및 테스트를 위해:

종속성 설치:
pip install -r requirements.txt
개발 서버를 실행합니다.
fastmcp dev notion_mcp_server.py

이렇게 하면 서버를 테스트하기 위한 MCP Inspector 인터페이스가 시작됩니다.

문제 해결

서버가 연결되지 않습니다
- .env 파일에서 API 키를 확인하세요
- Cline의 구성에서 서버 경로가 절대 경로인지 확인하세요.
- uv가 설치되어 있고 PATH에 있는지 확인하세요.
종속성 문제
- fastmcp install notion_mcp_server.py --force 로 다시 설치해보세요.
- uv가 올바르게 설치되었는지 확인하세요
서버가 멈춥니다
- config에 지정된 대로 uv run 명령을 사용하고 있는지 확인하세요.
- 서버 로그에서 오류를 확인하세요