Suekou MCP Notion Server

🚀 Notion MCP サーバーガイド

MCP（Multipurpose Control Panel）サーバーは、Notionインターフェースとの相互作用に使用される強力なツールです。これは、データベース項目の作成、読み取り、更新、削除、ユーザー管理、コメント処理など、さまざまな操作をサポートしています。この文書では、MCPサーバーの設定、使用、統合方法を詳細に説明し、完全な日本語翻訳を付けています。

🚀 クイックスタート

1. MCPインスタンスの作成

デフォルト設定でMCPサーバーを作成します。

from mcp_server import MCP

mcp = MCP()

2. サーバーの起動

以下のコマンドを実行して、MCPサーバーを起動します。

python mcp_server.py

デフォルトでは、サーバーはhttp://localhost:5000で動作します。

✨ 主な機能

以下は、MCPサーバーがサポートする主な機能とその詳細説明です。

1. ページの作成

   • 説明：Notionワークスペース内に新しいページを作成します。
   • パラメータ：
     • title：必須、文字列型。
     • parent_page_id：オプション、親ページのIDを指定します。

2. ページ内容の読み取り

   • 説明：指定されたページの内容と属性を取得します。
   • パラメータ：
     • page_id：必須、文字列型。

3. ページ属性の更新

   • 説明：既存のページの属性または内容を更新します。
   • パラメータ：
     • page_id：必須、文字列型。
     • properties：オプション、更新する属性と値を含む辞書形式。

4. ページの削除

   • 説明：指定されたページをNotionワークスペースから削除します。
   • パラメータ：
     • page_id：必須、文字列型。

5. データベースエントリの作成

   • 説明：指定されたNotionデータベース内に新しいエントリを作成します。
   • パラメータ：
     • database_id：必須、文字列型。
     • properties：必須、エントリの属性と値を含む辞書形式。

6. データベース内容の読み取り

   • 説明：指定されたデータベースのすべてのエントリを取得します。
   • パラメータ：
     • database_id：必須、文字列型。
     • page_size：オプション、整数型、1ページに表示するエントリ数を指定します。

7. データベースエントリの更新

   • 説明：既存のデータベースエントリの属性または内容を更新します。
   • パラメータ：
     • database_id：必須、文字列型。
     • entry_id：必須、文字列型。
     • properties：オプション、更新する属性と値を含む辞書形式。

8. データベースエントリの削除

   • 説明：指定されたデータベースから特定のエントリを削除します。
   • パラメータ：
     • database_id：必須、文字列型。
     • entry_id：必須、文字列型。

9. 内容の検索

   • 説明：Notionワークスペース内のページ、データベース、コメントを検索します。
   • パラメータ：
     • query：オプション、文字列型、検索キーワードを指定します。
     • filter：オプション、辞書形式、検索範囲を制限するために使用します（例：ページまたはデータベースのみ）。

10. ユーザー管理

    • 説明：すべてのユーザーをリスト表示、特定のユーザーの詳細情報を取得、新しいユーザーを作成します。
    • パラメータ：
      • user_id：オプション、文字列型。
      • username：オプション、文字列型。
      • email：オプション、文字列型。

11. コメントの処理

    • 説明：ページ上でコメントの作成、読み取り、更新、削除を行います。
    • パラメータ：
      • page_id：必須、文字列型。
      • comment_id：オプション、文字列型。
      • content：必須、文字列型。

📦 インストール

1. 依存関係のインストール

始める前に、以下のPythonライブラリをインストールしてください。

• notion：Notion APIとの相互作用に使用します。
• flask：Webインターフェースを作成するために使用します（オプション）。

以下のコマンドを実行してインストールします。

pip install notion python-dotenv flask

2. プロジェクト構造の初期化

新しいディレクトリを作成し、以下のファイルを追加します。

• config.py：Notion APIキーやデータベースIDなどの設定情報を保存します。
• mcp_server.py：MCPインターフェースの実装を含むメインサーバーファイルです。
• requirements.txt：すべての依存関係をリストします。

3. 環境変数の設定

config.pyに以下の内容を追加します。

NOTION_TOKEN = "your_notion_token"
DATABASE_ID = "your_database_id"

💻 使用例

基本的な使用法

1. 新しいページの作成

新しいページを作成するサンプルコードは次の通りです。

mcp.create_page(title="My New Page", parent_page_id="parent_page_id")

2. 既存のページ属性の更新

ページ属性を更新するサンプルコードは次の通りです。

properties = {
    "Status": "Published",
    "Priority": "High"
}
mcp.update_page_properties(page_id="page_id", properties=properties)

3. 内容の検索

Notionワークスペース内の内容を検索するには、以下のコードを使用できます。

results = mcp.search_content(query="search_term")
for result in results:
    print(result.title, result.type)

📚 ドキュメント

エラー処理

MCPサーバーは、検証エラー、認証エラー、ネットワークエラーなど、詳細なエラー処理メカニズムを提供しています。すべてのエラーは、対応する例外をスローし、エラー情報を付けます。

例

try:
    mcp.create_page(title="", parent_page_id="parent_id")
except ValueError as e:
    print(e)

📄 ライセンス

MCPサーバーはMITライセンスに準拠しており、このソフトウェアの自由な使用、修正、配布を許可しています。完全なライセンス内容は以下の通りです。

MIT License

Copyright (c) [Year] [Name]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

貢献ガイド

コミュニティからの貢献を歓迎します！何か問題を見つけたり、改善案がある場合は、GitHubリポジトリにIssueまたはPull Requestを送信してください。

貢献方法

1. このプロジェクトをForkします。
2. 新しい機能ブランチを作成します。
3. 変更をコミットします。
4. リモートリポジトリにPushし、Pull Requestを作成します。

お問い合わせ

何か質問やフィードバックがある場合は、開発チームにお問い合わせください。

• メール：contact@notionmcp.com
• GitHub：https://github.com/notionmcp

MCPサーバーを選んでいただき、ありがとうございます！Notionプロジェクトに便利な機能を提供できることを願っています。