OneNoteMCP

ZubeidHendricks/azure-onenote-mcp-server からフォークされています。元の README.md については、そちらのページをご覧ください。

概要

OneNote 向けの MCP です。フォーク後、大幅に改訂され、個人用ノートブックにも対応しました。 最新の MCP API に更新されています。認証情報のキャッシュに対応しています。

改善点

機能

• ReadableStream を実装し、getPageContent の機能を修正しました
• 個人用ノートブックに対する API 呼び出しを実装しました
• インデックスとツールを最新の MCP バージョンに更新しました

コードアーキテクチャ

• 不要なクラスを削除し、コードベースを簡素化しました
• 不要なファイルを多数削除しました

認証とパフォーマンス

• 認証情報をディスクにキャッシュする機能を実装しました
• パッケージの依存関係を更新しました
• 直接テストできるよう、dotenv のサポートを追加しました

Azure アプリの登録

1. Azure Portal に移動し、「アプリの登録」を開きます
2. OneNoteMCP の新しい登録を作成します
3. Microsoft Graph API のアクセス許可を追加します：
   • Notes.Read
   • Notes.Read.All
   • （必要に応じて Notes.Write のアクセス許可を追加できますが、ノートを失うリスクがあります）
4. クライアントシークレットを作成します
5. 設定用にクライアント ID とシークレットをコピーします
6. マニフェストで signInAudience を AzureADandPersonalMicrosoftAccount に設定します

MCP サーバーのセットアップ

クライアント ID とシークレットを、ローカルの .env ファイルと Claude デスクトップアプリの両方に記載してください。

AUTH_CACHE_DIR には、生成された API アクセストークンの保存先ディレクトリを指定します。

AZURE_CLIENT_ID=\
AZURE_CLIENT_SECRET=
AUTH_CACHE_DIR="C:\\git\\azure-onenote-mcp-server\\.cache"

サーバーを手動で起動し、認証情報を生成してください。生成された認証情報はキャッシュされ、後で Claude デスクトップアプリがサーバーを起動するときに使用されます。

npm install
npm build
npm run

サーバーの起動とログインが完了したら、次のコマンドを直接実行して API が動作することをテストできます。

{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "listNotebooks", "arguments": {}}}

Claude MCP の設定

{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": ["C:\\git\\azure-onenote-mcp-server\\dist\\index.js"],
      "env": {
        "AZURE_CLIENT_ID": "...",
        "AZURE_CLIENT_SECRET": "...",
        "AUTH_CACHE_DIR": "C:\\git\\azure-onenote-mcp-server\\.cache"
      }
    }
  }
}