makenotion/notion-mcp-server

해결하는 문제

이 프로젝트는 AI 에이전트가 Notion 워크스페이스와 상호작용할 수 있는 방법을 제공합니다. Model Context Protocol (MCP)를 구현함으로써 Notion API를 AI 클라이언트가 자동으로 탐지하고 사용할 수 있는 도구 세트로 전환하여, Notion 페이지 및 데이터베이스의 검색, 읽기, 편집이 가능하게 합니다.

작동 방식

서버는 MCP 호환 AI 클라이언트(예: Claude Desktop 또는 Cursor)와 Notion API 사이의 브리지 역할을 합니다. AI가 데이터 소스 쿼리, 페이지 메타데이터 검색, 페이지 이동 등의 작업에 사용할 수 있는 22가지 도구를 노출합니다. 토큰 효율을 높이기 위해, 일반적으로 Notion API에서 사용하는 복잡한 JSON 블록 형식 대신 마크다운 형식으로 페이지 내용을 읽고 쓸 수 있는 전용 도구도 포함되어 있습니다.

대상 사용자

자신의 Notion 워크스페이스와 AI 에이전트 간의 연결을 자체 호스팅하고 싶으며, API 토큰과 로컬 서버 설정을 직접 관리하는 데 익숙한 개발자 및 AI 고급 사용자.

주요 특징

• 마크다운 지원: 토큰 사용량을 줄이기 위해 페이지 읽기 및 편집을 위한 마크다운 전용 도구 포함.
• 유연한 전송 방식: 표준 입력/출력(STDIO)과 스트리머블 HTTP 전송을 모두 지원하여 웹 기반 애플리케이션에도 적합.
• 다중 테넌트 기능: 토큰 전달 기능을 통해 하나의 배포로 여러 Notion 통합을 제공할 수 있음.
• 포괄적인 도구 세트: 페이지 관리, 데이터베이스(데이터 소스) 쿼리, 콘텐츠 조작을 포함한 총 22개의 도구 제공.