MCP Notion Server

🚀 Notion MCP サーバー

Notion MCP サーバーは、Notion API を利用して、ページ管理やデータベース操作、ユーザー情報取得などの機能を提供するサーバーです。

🚀 クイックスタート

以下の手順に従って、Notion MCP サーバーをセットアップしてください。

📦 インストール

依存関係のインストール

必要な依存関係をインストールするには、以下のコマンドを実行します。

pip install python-dotenv requests

リポジトリのクローン

Git を使用してこのリポジトリをクローンします。

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

🔧 設定

設定ファイルの取得

config.env という名前の新しいファイルを作成し、以下の内容を追加します。

NOTION_TOKEN=あなたのNotionトークン
PORT=指定するポート（デフォルトは5000）

サーバーの起動

MCP サーバーを起動するには、メインスクリプトを実行します。

python3 mcp_server.py

⚠️ 重要提示

• 有効な Notion トークンを持っていることを確認してください。
• 設定ファイルの PORT は必要に応じて調整できます。

💡 使用建议

• サーバーを実行する際には、ネットワーク接続が正常であることを確認してください。
• 依存ライブラリの更新を定期的に確認し、最適なパフォーマンスとセキュリティを維持してください。

✨ 主な機能

基本機能

1. ページ管理

   • 新しいページを作成します。
   • 既存のページを更新します。
   • 指定されたページを削除します。

2. データベース操作

   • データベース項目をクエリします。
   • 新しいデータベース項目を作成します。
   • データベース項目を更新します。
   • データベース項目を削除します。

3. ユーザー操作

   • 現在のユーザー情報を取得します。
   • すべてのユーザー情報を取得します。
   • 現在の bot ユーザー情報を取得します。

4. コメント管理

   • ページまたはブロックにコメントを作成します。
   • 指定されたページのコメントをクエリします。
   • コメントを更新または削除します。

拡張機能

1. 一括操作

   • ページまたはデータベース項目を一括で作成します。
   • 属性を一括で更新します。
   • 一括削除操作を行います。

2. 高度なクエリ

   • 複雑な条件フィルタリングを行います。
   • ソートとページングを行います。
   • 関連クエリ（データベース関係を通じて）を行います。

3. イベント監視

   • ページまたはデータベースの変更をリアルタイムで監視します。
   • 事前に設定された操作を自動的にトリガーします。

4. ログ記録

   • すべての API 呼び出しのログを記録します。
   • 詳細なエラーレポートを提供します。

💻 使用例

ページの作成

POST /api/create_page
Content-Type: application/json

{
  "parent": {
    "database_id": "09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf"
  },
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "新しいページのタイトル"
          }
        }
      ]
    }
  },
  "children": []
}

ページの更新

PUT /api/update_page?id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd
Content-Type: application/json

{
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "更新後のページのタイトル"
          }
        }
      ]
    }
  },
  "children": []
}

ページの削除

DELETE /api/delete_page?id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd

データベースのクエリ

POST /api/query_database?database_id=09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf
Content-Type: application/json

{
  "filter": {
    "property": "Status",
    "value": {
      "status": {
        "equals": "完了"
      }
    }
  },
  "sorts": [
    {
      "property": "作成日時",
      "direction": "降順"
    }
  ],
  "start_cursor": "",
  "page_size": 10
}

データベース項目の作成

POST /api/create_database_item?database_id=09d4db7b-xxxx-xxxx-xxxx-c86ab25ef5cf
Content-Type: application/json

{
  "properties": {
    "Name": {
      "title": [
        {
          "text": {
            "content": "新しいデータベース項目"
          }
        }
      ]
    },
    "Status": {
      "select": {
        "name": "完了"
      }
    }
  },
  "children": []
}

ユーザー情報の取得

GET /api/get_user_info

コメントの作成

POST /api/create_comment
Content-Type: application/json

{
  "parent": {
    "page_id": "14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd"
  },
  "properties": {},
  "children": [
    {
      "object": "block",
      "type": "paragraph",
      "paragraph": {
        "rich_text": [
          {
            "type": "text",
            "text": {
              "content": "これは新しいコメントです。"
            }
          }
        ]
      }
    }
  ]
}

コメントの取得

GET /api/get_comments?page_id=14f5d08c-xxxx-xxxx-xxxx-d9e6b534a7cd

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については LICENSE ファイルを参照してください。

当社の MCP サーバーをご利用いただき、ありがとうございます！何か問題があれば、サポートチームにお問い合わせください。