Notion MCP

🚀 Notion MCP サーバー

Notion との統合に使用される Model Context Protocol (MCP) サーバーの実装です。Notion の API との相互作用を行うための標準化されたインターフェースを提供します。Claude Desktop やその他の MCP クライアントと互換性があります。

✨ 主な機能

• Notion データベースの一覧表示と検索
• ページの作成と更新
• Notion ワークスペース内での検索
• データベースの詳細情報とその子ブロックの取得
• 完全な非同期/待機機能のサポート（httpx を使用）
• Pydantic v2 モデルによる型安全の実現
• 詳細なログ記録を伴うエラー処理
• MCP 1.6.0 との互換性

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/ccabanillas/notion-mcp.git
cd notion-mcp

2. 仮想環境を作成し、依存関係をインストールします（uv を使用）：

uv venv
source .venv/bin/activate  # Windows では：.venv\Scripts\activate
uv pip install -e .

または、標準の venv を使用します：

python -m venv venv
source venv/bin/activate  # Windows では：venv\Scripts\activate
pip install -e .

3. プロジェクトのルートディレクトリに .env ファイルを作成します：

NOTION_API_KEY=your_notion_integration_token

💻 使用例

基本的な使用法

# サーバーをテストします（エラーなく正常に動作するはずです）
python -m notion_mcp

高度な使用法

# Claude Desktop と一緒に使用する場合は、`claude_desktop_config.json` ファイルを調整します（macOS では `~/Library/Application Support/Claude/claude_desktop_config.json`）
{
  "servers": {
    "notion-mcp": {
      "command": "/Users/username/Projects/notion-mcp/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/Users/username/Projects/notion-mcp"
    }
  }
}

/Users/username/ を実際のユーザーディレクトリのパスに置き換えてください。

📚 ドキュメント

プロジェクト構造

notion-mcp/
├── src/
│   └── notion_mcp/
│       ├── models/
│       │   ├── __init__.py
│       │   └── notion.py      # Notion オブジェクト用の Pydantic モデル
│       ├── __init__.py        
│       ├── __main__.py        # エントリポイント
│       ├── client.py          # Notion API クライアント
│       └── server.py          # MCP サーバー実装
├── .env                       # 環境変数（ここに Notion API キーを追加）
├── .gitignore
├── pyproject.toml             # プロジェクトの依存関係
└── README.md

テストの実行

pytest

設定

サーバーには Notion 統合トークンが必要です。この設定を行うには：

1. https://www.notion.so/my-integrations にアクセスします。
2. 新しい統合を作成します（適切な読み取り/書き込み権限を持つ）。
3. 生成されたトークンをコピーし、.env ファイルに追加します：

NOTION_API_KEY=your_api_key_here

貢献ガイド

このプロジェクトに貢献するには、以下の手順に従ってください：

1. プロジェクトのリポジトリをフォークします。
2. 新しいブランチを作成して、機能や修正を行います。
3. 変更をコミットし、ブランチをプッシュします。
4. メインブランチにマージするためのプルリクエストを作成します。

コードを提出する前にすべてのテストを実行し、コードの品質とドキュメントの明瞭さを維持するようにしてください。

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。

トラブルシューティング

一般的な問題

• 依存関係のインストールができない：インターネット接続を確認するか、別の Python バージョンを試してみてください。
• サーバーが起動しない：.env ファイルに API キーが正しく設定されていること、すべての依存関係が正しくインストールされていることを確認してください。
• Claude と互換性がない：claude_desktop_config.json 内のパスとコマンドが正しいことを確認してください。

連絡先

何か問題やフィードバックがある場合は、GitHub Issues を通じて提出してください。