README.md•2.78 kB
# 🧠 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