Notion MCP

🚀 Notion MCP クライアント

このクライアントは、Notion API とやり取りするための Model Context Protocol (MCP) クライアントです。現代の AI ツール（Claude など）で使用するために設計されており、MCP 拡張機能をサポートしています。

✨ 主な機能

• リトライロジックを持つ非同期 API 操作
• Notion API のレート制限を遵守するための並行制御
• 設定に基づく環境
• JSON に基づく操作設定
• MCP をサポートする柔軟なサーバー実装
• MCP が利用できない場合、標準の HTTP API にフォールバック

📦 インストール

pip install notion-mcp

またはソースコードからインストールするには：

git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
pip install -e .

MCP をサポートする追加のインストール：

pip install notion-mcp[mcp]

📚 ドキュメント

設定

.env ファイルを作成し、Notion API の認証情報と設定を含めます：

NOTION_TOKEN=your_notion_token_here
ROOT_PAGE_ID=your_root_page_id_here
MAX_RETRIES=3
RETRY_DELAYS=1,3,5
CONCURRENCY_LIMIT=5
TIMEOUT_MS=30000

使い方

コマンドライン

デフォルト設定で実行するには：

notion-mcp

カスタム JSON 設定ファイルで実行するには：

notion-mcp config.json

サーバー

サーバーを起動します（MCP が利用可能な場合は、それを使用しようとします）：

notion-mcp-server --host 0.0.0.0 --port 8000

サーバーは MCP プロトコルを使用しようとします。利用できない場合は、標準の HTTP サーバーにフォールバックし、/notion で POST リクエストを受け付けます。

HTTP API

HTTP API を使用する場合、/notion に JSON 本文を含む POST リクエストを送信します：

{
  "root_page_id": "your_page_id_here",
  "database_filter": ["Articles", "Resources"],
  "operation": {
    "type": "fill_web_url",
    "params": {
      "web_field": "网址"
    }
  }
}

curl を使用した例：

curl -X POST http://localhost:8000/notion \
  -H "Content-Type: application/json" \
  -d '{"root_page_id": "your_page_id_here", "operation": {"type": "fill_web_url"}}'

JSON 設定

動作をカスタマイズするために JSON 設定ファイルを作成します：

{
  "root_page_id": "your_page_id_here",
  "database_filter": ["Articles", "Resources"],
  "operation": {
    "type": "fill_web_url",
    "params": {
      "web_field": "网址"
    }
  }
}

Claude との連携

この MCP クライアントを Claude と一緒に使用するには、サーバーを設定し、Claude がそれを使用するように構成する必要があります。以下は例です：

{
  "mcp_configurations": [
    {
      "name": "notion",
      "endpoint": "http://localhost:8000/notion",
      "description": "访问和操作 Notion 数据"
    }
  ]
}

開発

このプロジェクトに貢献または拡張するには、リポジトリをクローンし、CONTRIBUTING.md ファイルを参照してください。

このドキュメントでは、Notion MCP クライアントのインストール、設定、使用方法、および現代の AI ツール（Claude など）との統合方法について説明しています。ご参考になれば幸いです！