Notion Chakra MCP

🚀 Notion Chakra MCP

このサービスはNotionに統合され、MCP（メッセージ制御プロトコル）エンドポイントを提供し、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設定

開発または独立した使用に適しています。

# stdio伝送を使用してビルドして起動する
TRANSPORT=stdio docker-compose up notion-chakra-mcp

# またはSSE伝送を使用する
TRANSPORT=sse docker-compose up notion-chakra-mcp

3. 直接Dockerを使用する

手動テストまたはカスタム設定に適しています。

# イメージをビルドする
docker build -t notion-chakra-mcp .

# stdio伝送で実行する
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

# SSE伝送で実行する
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

🔧 技術詳細

テストの実行

# テスト依存関係をインストールする
pip install -r requirements.txt

# テストを実行する
python -m pytest tests/ -v

新機能の追加

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