Onenotemcp

🚀 OneNoteのMCP（Microsoft Cloud Partner）

このプロジェクトはOneNote用のMCP（Microsoft Cloud Partner）です。元のプロジェクトを大幅に改修し、現在では個人用ノートブックをサポートしています。最新のMCP APIバージョンに更新し、認証情報のキャッシュ機能を実装しています。

✨ 主な機能

機能改善

• getPageContent機能をReadableStreamを実装することで修正しました。
• 個人用ノートブックに対する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は認証情報をキャッシュするディレクトリを指定します。

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"
      }
    }
  }
}