Microsoft 365 MCP サーバー

💡説明

現在、これは開発中であり、ソリューションというよりは概念実証（POC）段階です。目標は、Microsoft 365 のあらゆる CLI コマンドを実行できる MCP サーバーを構築することです。

📦 前提条件

Node.js 20.x 以上

🚀 ビルドと実行方法

まず最初にnpm install実行して、すべての依存関係をインストールします。

次に、プロジェクトをビルドするために次のコマンドを実行します。

npm run build

このツールをテストするには、Entra アプリ要件と証明書を作成して、この MCP サーバーがアプリとして Microsoft 365 に対して認証できるようにする必要があります。必要なスコープを持つ証明書とアプリ要件を作成し、それを証明書と共にテナントに追加するには、 createApp.ps1スクリプトを実行して、指示に従います。証明書を作成するときに、パスワード以外のほとんどの項目は空のままにできます。パスワードは必要です。スクリプトはMicrosoft 365 用 CLIを使用してアプリ要件などを作成するため、最初にnpm i -g @pnp/cli-microsoft365を使用して Microsoft 365 用 CLI をグローバルにインストールし、管理者としてテナントにサインインする必要があります。スクリプトを実行すると、必要なスコープと証明書を含む 'MCP Server Test' アプリレジストリが Entra ID に表示されます。また、証明書ファイルとエクスポートされた base64 でエンコードされた証明書がtempフォルダーに表示されます。これらは後で必要になります。

インスペクタを使用してMCPを実行する

M365 MCPサーバーをテストする方法の一つは、 MCP Inspectorを使用することです。まず、次のコマンドでM365 MCPサーバーを起動します。

npm run start

ここで、MCP サーバーのインスペクターを実行し、必要なパラメーターを環境として渡して、MCP サーバーがそれらを取得して Microsoft 365 に対する認証に使用できるようにするには、次のコマンドを実行します。

npx @modelcontextprotocol/inspector -e CertificatePassword='YOUR_PASSOWRD' -e AppId='ENTRA_APP_REG_ID' -e TenantId='TENANT_ID' -e TenantUrl='TENANT_URL' -e CertificateBase64Encoded='BASE64_ENCODED_VALUE_OF_YOUR_CERT' node dist/index.js

その後、インスペクターが起動するのを待ち、ブラウザでインスペクターを開きます。MCPサーバーが稼働していることが確認でき、ツールをクエリしてローカルで実行できるはずです。

VS CodeでMCPを実行する

GitHub Copilot Agent で使用できるように、VS Code のローカルビルドから MCP サーバーを実行することもできます。現時点では、これは VS Code Insiders のみでサポートされています。まず、以下のコマンドで M365 MCP サーバーを起動します。

npm run start

VS CodeのGitHub Copilot Agentモードに移動し、ツールアイコンをクリックしてAdd more toolsを選択します。次にAdd MCP serverを選択し、 Command (stdio)選択して、以下のコマンドを入力します。

node FULL_PATH_TO_YOUR_PROJECT/dist/index.js

Enterキーを押して、好きな名前を付けてください。テストのためにworkspaceスコープに追加することをお勧めします。その後.vscode/mcp.jsonファイルを開き、認証に必要な環境変数を渡すように修正してください。

{
    "servers": {
        "m365-mcp-server": {
            "type": "stdio",
            "command": "node",
            "args": [
                "FULL_PATH_TO_YOUR_PROJECT/dist/index.js" // e.g. C:/workspace/repo/microsoft-365-mcp-server/dist/index.js
            ],
            "env": {
                "CertificateBase64Encoded": "BASE64_ENCODED_VALUE_OF_YOUR_CERT",
                "CertificatePassword": "YOUR_PASSOWRD",
                "AppId": "ENTRA_APP_REG_ID",
                "TenantId": "TENANT_ID",
                "TenantUrl": "TENANT_URL" // e.g. https://tenanttocheck.sharepoint.com/
            }
        }
    }
}

「開始」をクリックすると、GitHub Copilot Agent に 4 つの新しいツールが追加されます。ぜひ試してみてください。

🎬 デモ

👉 映画 🎬

Microsoft 365 MCP Server