MCP 服务器

Microsoft 365 MCP Server

Adam-it

开发者工具

README

Microsoft 365 MCP 服务器

💡 描述

目前这还是一个正在进行中的项目，更像是一个概念验证 (POC) 而不是一个完整的解决方案。目标是创建一个 MCP 服务器，它允许运行任何类型的 Microsoft 365 命令行界面 (CLI) 命令。主要目的是使此 MCP 服务器准备好在 VS Code 中使用，以便 GitHub Copilot Agent 可以使用它。将来，此 MCP 服务器应作为专用 VS Code 扩展或 SPFx Toolkit VS Code 扩展的子扩展分发。在更远的将来，此 MCP 服务器不仅可以运行 CLI for Microsoft 365 命令，还可以拥有更多功能来支持 Microsoft 365 应用程序的开发，例如帮助创建 SPFx Web 部件、扩展或 Teams 应用程序或 M365 Copilot Agents。

📦 前提条件

Node.js 20.x 或更高版本

🚀 如何构建和运行

在开始之前，首先运行 npm install 以安装所有依赖项。

然后，为了构建项目，运行：

npm run build

为了测试这个工具，你需要创建一个 Entra 应用程序注册和一个证书，以便这个 MCP 服务器可以作为应用程序对 Microsoft 365 进行身份验证。为了创建证书和具有所需范围的应用程序注册，并将其与证书一起添加到你的租户，请运行 createApp.ps1 脚本并按照说明进行操作。创建证书时，大多数内容可以留空，除了密码。密码是必需的。由于该脚本使用 CLI for Microsoft 365 来创建应用程序注册和其他内容，因此你首先需要使用 npm i -g @pnp/cli-microsoft365 在全局范围内安装 CLI for Microsoft 365，并以管理员身份登录到你的租户。执行脚本后，你应该在你的 Entra ID 上看到一个“MCP Server Test”应用程序注册，其中包含所需的范围和证书。你还应该在 temp 文件夹中看到证书文件和导出的 base64 编码的证书。你稍后会需要它们。

使用 Inspector 运行 MCP

测试 M365 MCP 服务器的一种方法是使用 MCP Inspector。首先使用以下命令启动 M365 MCP 服务器：

npm run start

现在，为了运行你的 MCP 服务器的 Inspector，同时将所需的参数作为环境变量传递下去，以便 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

之后，等待 Inspector 启动并在浏览器中打开 Inspector。你应该看到 MCP 服务器正在运行，并且你应该能够查询工具并在本地执行它们。

inspector

在 VS Code 中运行 MCP

也可以从你的本地构建在 VS Code 中运行 MCP 服务器，以便 GitHub Copilot Agent 可以使用它。截至目前，这仅在 VS Code Insiders 中受支持。首先使用以下命令启动 M365 MCP 服务器：

npm run start

现在转到 VS Code GitHub Copilot Agent 模式，单击工具图标，然后选择“添加更多工具”。然后选择“添加 MCP 服务器”，然后选择“命令 (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" // 例如 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" // 例如 https://tenanttocheck.sharepoint.com/
            }
        }
    }
}