하나의 데이터베이스가 아닌 전체 Notion 작업 공간을 탐색하세요

토큰이 필요 없이 단일 ROOT_PAGE 변수만으로 MCP를 탐색하는 Markdown 기반 Notion입니다.

• Notion MCP 서버: notion-texonom
• Notion 페이지는 text/markdown MIMEType 노트로 변환됩니다.
• 부모-자식 관계와 참조 관계를 고려하여 그래프 거리를 기반으로 관련 페이지를 검색하고 조회합니다.

Notion 기반 노트를 관리하고 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 TypeScript 기반 서버는 Notion 페이지와 효율적으로 상호작용할 수 있도록 리소스, 도구 및 프롬프트를 통합하여 MCP 개념을 보여줍니다.

특징

자원

• 액세스 노트 : Notion 페이지를 UUID 슬러그를 포함한 note:// URI로 나열하고 검색합니다.
• 메타데이터 : 각 리소스에는 마크다운 형식의 제목, 설명 및 콘텐츠가 포함됩니다.
• MIME 유형 : 콘텐츠는 text/markdown 형식으로 접근 가능합니다.

도구

• 검색 노트 : search_notes 도구를 사용하여 쿼리 문자열을 사용하여 Notion 페이지를 검색합니다.
  • 입력: 관련 페이지를 필터링하기 위한 쿼리 텍스트입니다.
  • 출력: 일치하는 노트의 마크다운 콘텐츠.

프롬프트

• 요약 노트 : 개별 Notion 페이지에 대한 요약을 생성합니다.
  • 사용 가능한 프롬프트:
    • summarize_note : URI로 특정 노트를 요약합니다.
    • suggest_refactor : 구조적 개선 사항을 제안합니다.
    • suggest_fix : 메모 내용에 대한 잠재적인 수정 사항을 식별합니다.
    • suggest_enhance : 메모를 개선하기 위한 개선 사항을 추천합니다.
  • 입력: Notion 페이지 URI.
  • 출력: 요약 및 향상을 위한 구조화된 메시지.

개발

설정

종속성 설치:

지엑스피1

프로젝트를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

구성

Notion으로 서버를 구성하려면:

• 환경 변수 설정:
  • ROOT_PAGE : Notion 작업 공간의 루트 페이지 ID입니다.

Claude Desktop 설치

Claude Desktop과 함께 이 서버를 사용하려면 다음 구성을 추가하세요.

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

구성 예:

디버깅

MCP 서버 문제 해결 및 디버깅을 위해 MCP Inspector를 사용하세요. Inspector를 시작하려면 다음을 실행하세요.

Inspector는 stdio 기반 서버 통신을 검사하기 위한 브라우저 기반 인터페이스를 제공합니다.

핵심 기술

• Notion 통합: @texonom/nclient 및 @texonom/cli.
• MCP SDK: 서버 작업을 위해 @modelcontextprotocol/sdk 구현합니다.

원격 배포

이제 서버는 원격 통신에 SSEServerTransport 사용하여 서버를 공동으로 사용할 수 있습니다. 필요한 종속성이 설치되었고 서버가 원격 배포에 맞게 올바르게 구성되었는지 확인하세요.

사용 지침

SSEServerTransport 로 서버를 실행하려면 다음 명령을 사용하세요.

/some/folder 해당 폴더의 적절한 경로로 바꿔야 합니다.