MCP 服务器

ms-365-mcp-server

Microsoft 365 MCP 服务器

softeria

开发者工具

访问服务器

README

ms-365-mcp-server

Microsoft 365 MCP 服务器

一个用于通过 Graph API 与 Microsoft 365 服务交互的模型上下文协议 (MCP) 服务器。

快速开始示例

在 Claude Desktop 中登录并测试身份验证：

MS 365 MCP Server login example in Claude Desktop

功能

使用 Microsoft 身份验证库 (MSAL) 进行身份验证
Excel 文件操作：
- 更新单元格值
- 创建和管理图表
- 格式化单元格
- 排序数据
- 创建表格
- 读取单元格值
- 列出工作表
构建于模型上下文协议之上

安装

npx @softeria/ms-365-mcp-server

与 Claude 集成

Claude Desktop

要将此 MCP 服务器添加到 Claude Desktop：

启动 Claude Desktop
转到 Settings > MCPs
点击 "Add MCP"
设置以下配置：
- Name: ms (或您喜欢的任何名称)
- Command: npx @softeria/ms-365-mcp-server
- 点击 "Add"

或者，您可以直接编辑 Claude Desktop 的配置文件。位置因平台而异，但您可以通过转到 Settings > Developer > Edit Config 找到它。将此添加到您的配置文件：

{
  "mcpServers": {
    "ms": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server"
      ]
    }
  }
}

使用 Claude Code CLI

Claude Code CLI 集成可用，但配置方法可能因当前版本而异。请参阅官方 Claude Code 文档以获取有关添加 MCP 服务器的最新说明。

对于支持 MCP 的其他 Claude 界面，请参阅其各自的文档以获取正确的集成方法。

开发

设置

# 克隆存储库
git clone https://github.com/softeria-eu/ms-365-mcp-server.git
cd ms-365-mcp-server

# 安装依赖项
npm install

# 运行测试
npm test

GitHub Actions

此存储库使用 GitHub Actions 进行持续集成和部署：

Build Workflow: 在所有推送到 main 的提交和拉取请求上运行。验证项目是否成功构建并通过所有测试。
Publish Workflow: 在创建新的 GitHub 版本时自动发布到 npm。

发布流程

要创建新版本：

# 默认（补丁版本）：0.1.11 -> 0.1.12
npm run release

# 次要版本：0.1.11 -> 0.2.0
npm run release minor

# 主要版本：0.1.11 -> 1.0.0
npm run release major

此脚本将：

运行测试以验证一切正常
根据指定的类型（默认为补丁）增加版本号
提交版本更改
推送到 GitHub
创建 GitHub 版本
触发发布工作流程以发布到 npm

用法

命令行选项

npx @softeria/ms-365-mcp-server [options]

选项：

--login: 强制使用设备代码流登录并验证 Graph API 访问权限
--logout: 注销并清除保存的凭据
--test-login: 测试当前身份验证并验证 Graph API 访问权限，而不启动服务器
-v: 启用详细日志记录

身份验证

重要提示： 在使用 MCP 服务器之前，您必须进行身份验证。有两种身份验证方法：

使用 --login 标志运行服务器：
```
npx @softeria/ms-365-mcp-server --login
```
这将在终端中显示登录 URL 和代码。
使用 Claude Code 或其他 MCP 客户端时，请使用登录工具：
- 首先使用 login 工具，它将返回登录 URL 和代码
- 访问 URL 并在浏览器中输入代码
- 然后使用 verify-login 工具检查登录是否成功

两种方法都会触发设备代码流身份验证，但它们以不同的方式处理 UI 交互：

CLI 版本直接在终端中显示说明
MCP 工具版本将说明作为可以在客户端 UI 中显示的数据返回

您可以使用 --test-login 标志验证您的身份验证状态，该标志将检查您的令牌是否可以成功地从 Microsoft Graph API 获取用户数据：

npx @softeria/ms-365-mcp-server --test-login

如果身份验证成功，--login 和 --test-login 都将返回一个 JSON 响应，其中包含来自 Microsoft Graph API 的基本用户信息：

{
  "success": true,
  "message": "Login successful",
  "userData": {
    "displayName": "Your Name",
    "userPrincipalName": "your.email@example.com"
  }
}