使用说明

项目简介

MS 365 MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接大型语言模型 (LLM) 应用与 Microsoft 365 服务。它通过 Microsoft Graph API 提供对 Microsoft 365 数据和功能的访问，例如 OneDrive 文件、Outlook 日历和邮件、Excel 工作簿等。作为一个 MCP 服务器，它可以被 Claude Desktop 或其他兼容 MCP 协议的 LLM 客户端集成，从而使 LLM 能够安全、可控地访问和操作用户的 Microsoft 365 数据，实现更强大的上下文感知和功能扩展。

主要功能点

Microsoft 365 服务集成: 连接 Microsoft 365，支持访问和操作 OneDrive, Excel, Outlook Calendar, Outlook Mail 等服务。
文件和文件夹管理: 提供 OneDrive 文件的列表、获取、创建、删除、复制、移动、重命名、搜索、共享链接管理等功能。
Excel 操作: 支持 Excel 工作簿的单元格值更新、图表创建和管理、单元格格式化、数据排序、表格创建、数据读取、工作表列表等功能。
日历管理: 提供 Outlook 日历的列表、事件列表、事件创建、更新、删除、接受/拒绝邀请、查找会议时间等功能。
邮件管理: 支持 Outlook 邮件的列表和详细信息获取功能。
基于 MCP 协议: 遵循 Model Context Protocol 标准，易于集成到支持 MCP 的 LLM 客户端。
安全认证: 使用 Microsoft Authentication Library (MSAL) 进行安全的用户身份验证和授权。
命令行工具: 提供简单的命令行界面，方便安装、配置和测试。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node.js 包管理器)。
安装 MS 365 MCP Server: 打开终端或命令提示符，运行以下命令全局安装 MS 365 MCP Server：
```
npm install -g @softeria/ms-365-mcp-server
```
或者，您也可以选择不全局安装，而在项目中使用 'npx' 运行。

服务器配置

要将 MS 365 MCP Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置 MCP 服务器的启动命令。以下是 Claude Desktop 的配置示例：

Claude Desktop 配置 (JSON 格式):

{
  "mcpServers": {
    "ms365": {  // 服务器名称，可以自定义，例如 "ms365", "office", "m365" 等
      "command": "npx",
      "args": [
        "@softeria/ms-365-mcp-server" // 运行 MS 365 MCP Server 的命令
      ]
    }
  }
}

配置说明:

'"ms365"': 这是您为该 MCP 服务器设置的名称，在 Claude Desktop 中用于标识和选择该服务器。您可以自定义名称。
'"command": "npx"': 指定用于启动服务器的命令。'npx' 允许您运行未全局安装的 npm 包。如果全局安装，可以直接使用 '"command": "@softeria/ms-365-mcp-server"'。
'"args": ["@softeria/ms-365-mcp-server"]': 传递给 'npx' 命令的参数，即要执行的 npm 包名称。

Claude Desktop 配置步骤:

启动 Claude Desktop 应用程序。
点击 "Settings" (设置) 图标 (通常是齿轮状)。
在设置菜单中，选择 "MCPs" (MCP 服务器)。
点击 "Add MCP" (添加 MCP 服务器) 按钮。
在弹出的配置界面中，填写以下信息：
- Name (名称): 例如 'ms365' (与 JSON 配置中的服务器名称一致)。
- Command (命令): 'npx'
- Arguments (参数): '@softeria/ms-365-mcp-server'
点击 "Add" (添加) 按钮保存配置。

或者，您也可以直接编辑 Claude Desktop 的配置文件（通过 "Settings > Developer > Edit Config" 找到配置文件路径），将上述 JSON 配置添加到 'mcpServers' 部分。

对于 Claude Code CLI 或其他支持 MCP 的客户端，请参考其官方文档了解具体的 MCP 服务器配置方法。

基本使用方法

启动 MCP 服务器: Claude Desktop 或其他 MCP 客户端在配置完成后，会自动尝试连接并启动 MS 365 MCP Server。您也可以在终端中手动运行 'npx @softeria/ms-365-mcp-server' 来启动服务器。
身份验证: 首次使用时，您需要进行 Microsoft 365 身份验证。
- 通过命令行登录: 在终端中运行 'npx @softeria/ms-365-mcp-server --login'，按照提示在浏览器中完成登录授权。
- 通过 MCP 客户端登录: 在 Claude Desktop 或其他客户端中，可以使用 'login' 工具开始登录流程。客户端会显示登录 URL 和代码，您需要在浏览器中访问 URL 并输入代码进行授权。然后使用 'verify-login' 工具验证登录是否成功。
使用 MCP 工具: 登录成功后，您可以在 MCP 客户端中使用 MS 365 MCP Server 提供的各种工具，例如：
- 使用 'list-files' 工具列出 OneDrive 文件。
- 使用 'get-range' 工具读取 Excel 文件中的数据。
- 使用 'create-event' 工具在 Outlook 日历中创建事件。
- ... 等等。
具体的工具和参数请参考仓库 README.md 文档中 "MCP Tools" 部分的详细说明。

命令行选项

MS 365 MCP Server 提供了一些命令行选项，用于管理身份验证和日志记录：

'--login': 强制重新登录 Microsoft 365 并验证 Graph API 访问权限。
'--logout': 注销 Microsoft 365 账户并清除保存的凭据。
'--test-login': 测试当前身份验证状态并验证 Graph API 访问权限，但不启动服务器。
'-v': 启用详细日志输出，方便调试。

您可以通过 'npx @softeria/ms-365-mcp-server --help' 命令查看完整的命令行选项列表和使用说明。

关键词