Azure Onenote MCP Server

🚀 OneNote MCP サーバー

このサーバーは、Microsoft OneNote 用の Model Context Protocol (MCP) サーバーの実装で、AI 言語モデルが標準化されたインターフェースを通じて OneNote とやり取りできるようにします。

🚀 クイックスタート

OneNote MCP サーバーは、AI 言語モデルが標準化されたインターフェースを通じて Microsoft OneNote とやり取りできるようにするための実装です。以下では、このサーバーのインストール、設定、使用方法について説明します。

✨ 主な機能

ノートブック管理

• すべてのノートブックを一覧表示
• 新しいノートブックを作成
• ノートブックの詳細情報を取得
• ノートブックを削除

セクション管理

• ノートブック内のセクションを一覧表示
• 新しいセクションを作成
• セクションの詳細情報を取得
• セクションを削除

ページ管理

• セクション内のページを一覧表示
• HTML コンテンツを使用して新しいページを作成
• ページのコンテンツを読み取る
• ページのコンテンツを更新
• ページを削除
• ノートブック内でページを検索

📦 インストール

npm からのインストール（推奨）

npm install -g mcp-server-onenote

このパッケージは、2025 年 4 月 27 日から npm レジストリで利用可能です。

パッケージの実行

インストールが完了したら、以下のコマンドを使用して実行できます。

mcp-server-onenote

または npx を使用して：

npx mcp-server-onenote

Smithery を使用したインストール

Smithery を通じて Claude デスクトップ版用に OneNote サーバーを自動インストールするには：

npx -y @smithery/cli install @modelcontextprotocol/server-onenote --client claude

GitHub からのインストール

npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

📚 ドキュメント

設定

以下の環境変数を設定してください。

• AZURE_TENANT_ID：あなたの Azure テナント ID
• AZURE_CLIENT_ID：あなたの Azure アプリ（クライアント）ID
• AZURE_CLIENT_SECRET：あなたの Azure クライアントシークレット

MCP クライアントとの連携

MCP クライアントの設定ファイル（例えば Claude デスクトップ用）に以下の内容を追加します。

{
  "mcpServers": {
    "onenote": {
      "command": "mcp-server-onenote",
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Azure アプリの登録

1. Azure Portal にアクセスし、アプリ登録に移動します。
2. 新しい登録を作成します。
3. Microsoft Graph API のアクセス許可を追加します。
   • Notes.ReadWrite.All
   • Notes.Read.All
4. クライアントシークレットを作成します。
5. 設定用にテナント ID、クライアント ID、クライアントシークレットをコピーします。

🔧 技術詳細

開発

# 依存関係のインストール
npm install

# テストの実行
npm test

# ビルド
npm run build

# フォーマット
npm run lint

# ローカルでの実行
npm start

🤝 貢献

貢献に関する情報は、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で利用可能です。詳細は LICENSE ファイルを参照してください。

📈 変更履歴

0.1.0 (2025-04-27)

• 初回リリース
• OneNote ノートブック、セクション、ページ管理のコア機能
• npm レジストリへの公開

0.1.1 (2025-04-28)

• 環境変数の設定問題を修正
• 明確なインストール手順を提供するためにドキュメントを更新