Notion 지식 기반 MCP 서버

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

특징

• Cline에서 직접 Notion 지식 기반을 쿼리하세요

• Notion 페이지를 참조하여 자세한 답변을 얻으세요

• 안정적인 성능을 위해 FastMCP로 구축됨

• 포괄적인 오류 처리 및 로깅

Related MCP server: Notion MCP Server

필수 조건

• 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 지식 베이스에 대한 질문을 통해 서버를 사용할 수 있습니다. 예:

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"
      }
    }
  }
}

개발

개발 및 테스트를 위해:

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