CLI for Microsoft 365 MCP Server

CLI for Microsoft 365 MCP Server

💡 描述

此MCP服务器允许使用自然语言执行Microsoft 365命令的任何CLI。它可以处理复杂的提示，这些提示将作为Microsoft 365命令的CLI链执行，这些命令将尝试满足用户的请求。因此，您可以管理Microsoft 365的许多不同领域，例如：Entra ID、OneDrive、OneNote、Outlook、Planner、Power Apps、Power Automation、Power Platform、SharePoint Embedded、SharePoint Online、Teams、Viva Engage等等。..

为了获得最佳效果，请将其与克劳德十四行诗4或克劳德十四行诗3.7一起使用。

📦 先决条件

• Node.js 20.x或更高版本
• 全球安装的Microsoft 365 CLI(npm i -g @pnp/cli-microsoft365)

🚀 安装与使用

👉 Check out the CLI for Microsoft 365 MCP Server Guide

👉 Check out the Getting Started recording 🎬

此MCP服务器使用全局安装的 适用于Microsoft 365的命令行界面 您需要使用全局安装 npm i -g @pnp/cli-microsoft365.

安装Microsoft 365的CLI后，通过运行以下命令执行初始设置：

m365 setup

有关更多信息，请按照 登录Microsoft 365

为Microsoft 365设置CLI后，请使用以下命令更新其配置：

m365 cli config set --key prompt --value false
m365 cli config set --key output --value text
m365 cli config set --key helpMode --value full

这将确保当发生错误或命令执行不正确时，MCP服务器将从Microsoft 365的CLI获取尽可能多的信息。

MCP服务器不会为您进行任何身份验证。您需要首先使用Microsoft 365的CLI进行身份验证，使用 m365登录 命令。一旦您通过身份验证，MCP服务器在运行任何工具时都将使用相同的身份验证上下文。

最后，参考所选MCP主机的说明，在首选MCP客户端上安装MCP服务器。下面，您可以找到VS Code的指导。

添加到VS代码

有多种方法可以将MCP服务器添加到VS代码中。最常见的方法是：

1. 打开命令面板（macOS上的Ctrl+Shift+P或Cmd+Shift+P）并键入 MCP: Add Server.

1. 选择 Command (stdio) 作为服务器类型。

1. 输入运行MCP服务器的命令，即：

   npx -y @pnp/cli-microsoft365-mcp-server@latest

1. 命名服务器（例如。， CLI for Microsoft 365 MCP Server).

因此，您应该在您的 .vscode/mcp.json 文件：

{
    "servers": {
        "CLI for Microsoft 365 MCP Server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pnp/cli-microsoft365-mcp-server@latest"
          ]
        }
    }
}

现在，当您在VS Code中打开GitHub Copilot聊天时，您应该能够选择 CLI for Microsoft 365 MCP Server 从可用MCP服务器列表中选择一个，并开始使用它来使用自然语言管理Microsoft 365。在提示中指定“正在使用Microsoft 365的CLI，我希望您…”，GitHub Copilot Agent将使用MCP服务器执行您的请求。

添加到GitHub Copilot CLI

如果您正在使用 ，您可以通过执行以下操作将Microsoft 365 MCP服务器的CLI添加到Copilot：

1. 首先，开始 Copilot命令行界面 通过运行：

  copilot

1. 使用副驾驶mcp命令添加mcp服务器：

  /mcp add

1. 这将打开MCP表格，您需要在其中填写以下详细信息：

• 服务器名称：基本上是你喜欢的任何名称，但不要使用空格键字符，例如 cli-microsoft365-mcp-server
• 服务器类型：选择 Local
• 命令： npx
• 论据： "-y", "@pnp/cli-microsoft365-mcp-server@latest"

其余字段可以保留默认值。

之后点击 Ctrl+S 保存MCP服务器 q 退出MCP表单。 现在，您应该能够在GitHub Copilot CLI中使用Microsoft 365 MCP服务器的CLI，方法是在提示符中指定它，例如“使用Microsoft 365的CLI，我希望您…”。

添加到克劳德

使用时 克劳德桌面版 您可以通过手动将MCP服务器添加到Claude Desktop配置中来添加它。

手动添加到Claude Desktop配置

1. 在Claude Desktop中，单击左上角的汉堡包图标打开设置。
2. 选择“文件”>“设置”（或按 Ctrl + ,)
3. 在“开发人员”选项卡中，单击“编辑配置”

注意：如果看不到“开发人员”选项卡，则需要先从“帮助”>“启用开发人员模式”启用它。

1. 这将打开资源管理器，编辑 claude_desktop_config.json 在您最喜欢的文本编辑器中。

将以下配置添加到文件中。

{
  "mcpServers": {
    "CLI-Microsoft365": {
      "command": "npx",
      "args": ["-y", "@pnp/cli-microsoft365-mcp-server@latest"]
    }
  }
}

1. 退出Claude Desktop并重新启动。每次更改代码或配置时，都需要重新启动Claude Desktop才能使更改生效。

注意：在Windows中，当您关闭窗口时，Claude不会退出，它会在后台运行。您可以在系统托盘中找到它。右键单击图标并选择退出以完全退出应用程序。

全部完成！您现在应该可以使用 CLI-Microsoft365 Claude Desktop中的MCP服务器。

添加到光标

使用时 光标 您可以通过执行以下操作添加MCP服务器：

1. 从聊天选项中选择 Agent settings 选项
2. 首选 Tools & MCP 选项卡并单击 New MCP server
3. 修改 mcp.json 配置如下：

{
  "mcpServers": {
    "CLI for Microsoft 365 MCP Server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pnp/cli-microsoft365-mcp-server@latest"
      ]
    }
  }
}

1. 在中保存并启用“Microsoft 365 MCP服务器CLI” Tools & MCP 选项卡并等待工具加载。

📷 用例

以下用例只是您如何使用此MCP服务器的几个示例。它能够处理许多不同的任务，所以可以自由地尝试它，并基本上使用自然语言管理所有的Microsoft 365。

管理SharePoint在线

在下面的示例中，MCP服务器创建了一个包含新列的SharePoint列表，并用一些测试项填充了它。

提示： “向此网站添加一个标题为“真棒鸭子”的新列表。然后向该列表添加新列，将其包含在默认视图中。第一列应该是文本描述列，第二列应该是用户列。”。 然后在这个列表中添加3个项目，在描述栏中添加一些关于文档的有趣笑话，在用户栏中添加我的用户。使用表情符号🙂"

管理Microsoft团队

以下示例显示了如何创建新的Microsoft Teams团队并将欢迎帖子添加到常规频道。

提示： “在团队中创建一个名为“Awesome Ducks”的新团队，并在常规频道添加一个欢迎帖子”

管理Power Platform解决方案

在该示例中，MCP服务器禁用Power Automation流。

提示： “你能检查我是否有HoursReportingReminder流吗？如果有，请禁用它”

管理计划员

在下面的示例中，MCP服务器使用示例桶和任务创建了一个新的Planner计划。

提示： “你能在planner中创建一个新的计划来管理这些很棒的鸭子的工作吗？我需要一些示例桶和任务来开始”

🛠️ 工具

🎓 技能

此仓库包含自定义的GitHub Copilot技能，可教AI如何有效地使用Microsoft 365的CLI。当检测到相关任务时，GitHub Copilot会自动加载技能。

🏗️ 如何在本地构建和运行它

在做任何事情之前，先跑 npm install 安装所有依赖项。

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

npm run build

在本地构建的VS代码中运行MCP

也可以在本地构建的VS Code中运行MCP服务器，以便GitHub Copilot Agent可以使用它。 首先，使用以下命令启动Microsoft 365 MCP服务器的CLI：

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

使用检查器从本地构建运行MCP（调试）

测试Microsoft 365 MCP服务器CLI的方法之一是使用 MCP检查员. 大多数情况下，此设置用于调试目的和本地测试MCP服务器。 首先，使用以下命令启动MCP服务器：

npm run start

现在，为了运行MCP服务器的检查器，您需要在repo根文件夹位置运行以下命令：

npx @modelcontextprotocol/inspector node dist/index.js

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

🔗 资源

• 打字sdk
• MCP服务器
• MCP检查员