mcp-server-notion

Notion과 연동되는 Model Context Protocol(MCP) 서버 툴입니다. 이 서버는 외부 시스템 또는 LLM 기반 에이전트가 Notion 데이터베이스에 자동으로 내용을 추가하거나, 다양한 노션 자동화 작업을 수행할 수 있도록 지원합니다.

주요 기능

• Notion 데이터베이스에 자동으로 콘텐츠 생성
• MCP 표준 프로토콜 기반의 툴 등록 및 호출
• Python 기반의 간단한 확장성

설치 방법

1. 패키지 설치 (PyPI 배포 후)

pip install mcp-server-notion

2. 의존성 설치 (개발 환경)

pip install -r requirements.txt

실행 방법

uvx 또는 python -m 으로 실행

uvx mcp-server-notion
# 또는
python -m mcp_server_notion

MCP 서버 등록 예시 (mcp.json)

{
  "mcpServers": {
    "notion": {
      "command": "uvx",
      "args": ["mcp-server-notion"]
    }
  }
}

사용 예시

• 노션 API 토큰과 parent_id(페이지/데이터베이스 ID)를 준비합니다.
• MCP 툴 프롬프트 예시:

notion_create_page 툴을 사용해서 노션에 페이지를 만들어줘.
notion_token: [YOUR_NOTION_TOKEN]
parent_id: [YOUR_PAGE_OR_DATABASE_ID]
title: 예시 제목
content: 예시 내용

배포 방법

자동 배포 (GitHub Actions)

이 프로젝트는 GitHub Actions를 통해 자동으로 PyPI에 배포됩니다.

1. PyPI API 토큰 설정

1. PyPI에 로그인
2. Account Settings → API tokens → Add API token
3. Token name: github-actions
4. Scope: Entire account (all projects)
5. 생성된 토큰을 복사

2. GitHub Secrets 설정

1. GitHub 저장소 → Settings → Secrets and variables → Actions
2. "New repository secret" 클릭
3. Name: PYPI_API_TOKEN
4. Value: 위에서 생성한 PyPI API 토큰

3. 배포 트리거

• 태그 기반 배포: v1.0.0, v1.1.0 등의 태그를 푸시하면 자동 배포
• 메인 브랜치 배포: main 브랜치에 푸시할 때마다 자동 배포

# 태그로 배포
git tag v0.2.1
git push origin v0.2.1

# 또는 main 브랜치에 푸시
git push origin main

수동 배포

# 빌드
python -m build

# PyPI에 업로드
python -m twine upload dist/*

개발 환경 설정

# 의존성 설치
pip install -r requirements.txt

# 개발 의존성 설치 (uv 사용)
uv sync --dev