Notion Knowledge Base MCP Server

Notion 지식 기반 MCP 서버

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

특징

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

필수 조건

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

설치

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

용법

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

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

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

구성

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

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

구성 예:

개발

개발 및 테스트를 위해:

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

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

문제 해결

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

기여하다

서버 구현 및 아키텍처에 대한 자세한 내용은 mcp_instructions.md를 참조하세요.

특허

MIT