Notion MCP Server

# 🧠 Notion MCP Server ## 레퍼런스 영상  > **Master Control Panel for Notion** > Your Notion workspace, now supercharged as a real-time backend server. Notion MCP(Server)는 Notion을 단순한 노트 앱이 아닌, **조직의 모든 데이터를 실시간으로 제어할 수 있는 마스터 오퍼레이팅 시스템**으로 진화시키는 서버입니다. --- ## 🚀 Features - 🔗 **Notion API 기반 통합 백엔드** - Notion DB를 실제 API처럼 읽고, 정제하고, 가공해요. - ⚡ **SSG/SSR 웹사이트용 JSON 엔드포인트 제공** - Next.js, Nuxt 등 프론트 프레임워크와 쉽게 연동 가능해요. - 🧭 **컨텐츠 캘린더, 채용 시스템, 업무 관리 등 다양한 MCP 템플릿 지원** - 🔐 **보안 토큰 인증 지원 (API Key 기반)** > ☁️ MCP를 통해 Notion을 **CMS, CRM, ATS, Task Manager**로 자유롭게 확장해보세요. --- ## 🛠 기술 스택 * Node.js / TypeScript * Express.js 기반 REST API * Notion Official API v1 * .cursor/mcp.json 환경변수 기반 구성 * Docker 컨테이너 지원 --- ## 🧪 확장 아이디어 * GPT API와 연동해 요약, 자동 분류 기능 추가 * Slack, Discord Webhook 연결로 실시간 알림 * 관리자용 Dashboard UI 추가 (React, Next.js 기반) * 캐싱 서버(Firebase/Supabase) 연동으로 성능 개선 --- ## 🧬 왜 Notion MCP Server인가요? 우리는 모두 Notion을 사랑하지만, 그 안의 데이터를 **실제로 "제어"하거나 "활용"하는 데는 한계**를 느껴요. 그래서 Notion MCP는 단순한 통합 도구가 아니라, **Notion을 “진짜 백오피스”로 만드는 OS입니다.** --- ## 💬 Contact 만든 사람: [하리아빠 (@HariFatherKR)](https://github.com/HariFatherKR) 질문이나 협업 제안은 언제든지 Issues 또는 Discussions에 남겨주세요! --- > **당신의 Notion, 이제는 서버가 됩니다.** > → `Notion MCP Server` --- ## 🐳 Docker로 실행하기 ### 준비 사항 1. Docker 및 Docker Compose 설치 2. Notion API 토큰 발급 ([Notion Developers](https://developers.notion.com/)에서 발급 가능) ### 환경 설정 1. `.env` 파일 생성: ``` PORT=3000 NOTION_TOKEN=your_notion_token_here ``` ### 도커 이미지 빌드 및 실행 ```bash # 도커 이미지 빌드 및 컨테이너 실행 docker-compose up -d # 로그 확인 docker-compose logs -f # 컨테이너 중지 docker-compose down ``` ### 직접 실행 (도커 없이) ```bash # 의존성 설치 npm install # 서버 실행 npm start ``` 서버가 실행되면 다음 주소로 접속할 수 있습니다: - API 서버: http://localhost:3000 - API 문서: http://localhost:3000/api-docs