Onenote Browser

🚀 OneNote MCP サーバー

このサーバーは、ブラウザーを自動化して OneNote のウェブアプリケーションを閲覧および操作するための Model Context Protocol (MCP) サーバーです。AI アシスタントやその他の MCP 互換クライアントが、ネットワークリンクで共有された OneNote ノートブックをプログラムで閲覧および操作できるようになります。

✨ 主な機能

• OneNote の階層構造（ノートブック、セクション、ページ）を閲覧する
• OneNote からページの内容を読み取る
• 既存のページに新しい内容を追加する
• 新しいページを作成する
• OneNote 内で検索する
• 現在のビューのスクリーンショットを撮る
• セッション中の状態を維持する

📦 インストール

# リポジトリをクローンするか、プロジェクト構造を作成する
# その後、プロジェクトディレクトリに移動する
cd onenote-mcp

# パッケージと依存関係をインストールする
pip install -e .

# Playwright ブラウザーをインストールする
playwright install

💻 使用例

基本的な使用法

サーバーを直接実行することができます。

python -m onenote_mcp

高度な使用法

Claude Desktop や他の MCP ホストと統合する場合：

1. 設定ファイルを編集して、Claude Desktop が OneNote MCP サーバーを使用するように設定します。

{
  "mcpServers": {
    "onenote": {
      "command": "python",
      "args": ["-m", "onenote_mcp"]
    }
  }
}

2. Claude Desktop を起動すると、自動的に OneNote MCP サーバーが起動します。
3. Claude とのチャットで提供されるツールを使用します。

あなたは私の OneNote ノートブック https://example.com/my-shared-notebook に移動してくれますか？
まず、この URL の OneNote を開いて、利用可能なノートブックを教えてください。

利用可能なツール

• launch_onenote(shared_url): 共有されたノートブックの URL を使用して OneNote ウェブアプリを開きます。
• get_all_notebooks(): すべての利用可能なノートブックをリストします。
• get_all_sections(): 現在のノートブック内のすべてのセクションをリストします。
• get_all_pages(): 現在のセクション内のすべてのページをリストします。
• navigate_to_notebook_by_name(notebook_name): 特定のノートブックに移動します。
• navigate_to_section_by_name(section_name): 特定のセクションに移動します。
• navigate_to_page_by_name(page_name): 特定のページに移動します。
• get_current_page_content(): 現在のページの内容を取得します。
• add_content_to_page(content): 現在のページに内容を追加します。
• create_new_page_with_name(page_name): 新しいページを作成します。
• search_in_onenote(search_term): OneNote 内で特定の用語を検索します。
• take_screenshot(): 現在のビューのスクリーンショットを撮ります。
• get_onenote_state(): 現在の状態情報を取得します。
• close_onenote(): OneNote セッションを閉じてリソースをクリーンアップします。

🔧 技術詳細

この MCP サーバーは、ブラウザー自動化フレームワークである browser-use を使用して、OneNote のウェブインターフェースとやり取りします。MCP 互換の AI アシスタントと OneNote ウェブアプリケーションの間に橋渡しをし、OneNote の機能をプログラムで制御できるようにします。

📚 ドキュメント

制限事項

• パブリックリンクで共有された（認証不要）OneNote ノートブックにのみ適用されます。
• OneNote のウェブインターフェースが変更された場合、サーバーを調整する必要があるかもしれません。
• ブラウザー自動化はある程度脆弱で、UI 構造に依存しています。
• パフォーマンスはネットワーク条件や OneNote の応答速度によって異なる場合があります。

注意事項

⚠️ 重要提示

すべての必須の依存関係（Python、browser-use、MCP SDK、Playwright）がインストールされていることを確認してください。 サーバーを実行する前に、有効な OneNote ノートブックの URL があることを確認してください。 問題が発生した場合は、ログを確認するか、関連するドキュメントを参照してください。