Notion Chakra MCP

Notion Chakra MCP

これは、Notion のデータベースやページを操作するための MCP（Message Control Protocol）エンドポイントを提供する Notion 統合サービスです。

機能

• Notion のデータベースの一覧表示とクエリ
• ページの作成と更新
• Notion コンテンツの検索
• ブロックと子要素の管理
• stdio と SSE の両トランスポートに対応

セットアップ方法

1. MCP クライアントの設定（推奨）

~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "notion-chakra-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/notion-chakra-mcp/data:/app/data",
        "-e",
        "TRANSPORT",
        "-e",
        "NOTION_API_KEY",
        "-e",
        "HOST",
        "-e",
        "PORT",
        "-e",
        "PYTHONPATH=/app/src",
        "notion-chakra-mcp"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "NOTION_API_KEY": "your_notion_api_key",
        "HOST": "0.0.0.0",
        "PORT": "8050"
      }
    }
  }
}

以下の点を確認してください。

1. /path/to/notion-chakra-mcp を実際のプロジェクトパスに置き換えます
2. NOTION_API_KEY の値を設定します
3. プロジェクトのルートに data ディレクトリを作成します：mkdir -p data

2. Docker Compose のセットアップ

開発または単独での使用には、Docker Compose を使用できます。

# Build and start with stdio transport
TRANSPORT=stdio docker-compose up notion-chakra-mcp

# Or with SSE transport
TRANSPORT=sse docker-compose up notion-chakra-mcp

3. Docker を直接使用する

手動テストやカスタム設定の場合：

# Build the image
docker build -t notion-chakra-mcp .

# Run with stdio transport
docker run --rm -i \
  -v $(pwd)/data:/app/data \
  -e TRANSPORT=stdio \
  -e NOTION_API_KEY=your_key \
  -e PYTHONPATH=/app/src \
  notion-chakra-mcp

# Run with SSE transport
docker run --rm -i \
  -v $(pwd)/data:/app/data \
  -e TRANSPORT=sse \
  -e NOTION_API_KEY=your_key \
  -e HOST=0.0.0.0 \
  -e PORT=8050 \
  -p 8050:8050 \
  -e PYTHONPATH=/app/src \
  notion-chakra-mcp

設定

環境変数

• NOTION_API_KEY：Notion 統合トークン（必須）
• TRANSPORT：トランスポートの種類（stdio または sse、デフォルトは stdio）
• HOST：SSE トランスポート用のサーバーホスト（デフォルトは 0.0.0.0）
• PORT：SSE トランスポート用のサーバーポート（デフォルトは 8050）
• PYTHONPATH：Python モジュールのパス（/app/src に設定してください）

データの永続化

このサービスは、永続ストレージとして data ディレクトリを使用します。

• コンテナ内の /app/data にマウントされます
• スキーマ、データベースのマッピング、その他の永続データを保存します
• コンテナの実行前に作成する必要があります：mkdir -p data

開発

テストの実行

# Install test dependencies
pip install -r requirements.txt

# Run tests
python -m pytest tests/ -v

新機能の追加

1. src/ に機能の実装を追加します
2. tests/ にテストを追加します
3. 必要に応じて requirements.txt を更新します
4. テストを実行し、すべてが正常に動作することを確認します