Microsoft 365 SharePoint

@mindstone/mcp-server-microsoft-sharepoint

Microsoft 365 SharePoint MCP 服务——通过 Microsoft Graph API 发现站点、浏览文档库、读取页面和列表、搜索内容，并对 SharePoint 文件和列表执行变更操作。

面向协作组的 SharePoint MCP。它拥有自己的 authenticate_sharepoint 工具，主机可据此在协作组的 Microsoft 365 基础 OAuth 授权范围上，增量请求 Sites.Read.All 权限。

状态

• 版本： 0.2.1 · npm
• 身份验证： OAuth（由主机协调的增量授权，通过 authenticate_sharepoint 实现）(MS_CLIENT_ID)
• 工具： 46（身份验证 + 站点、文档库、页面、列表、元数据、搜索、变更操作）
• 接口类型： cloud-api
• 机器可读信息： STATUS.json
• 共享库： @mindstone/mcp-server-microsoft-shared

为什么要开发此项目

我们在 2026 年 5 月移植此项目时，Microsoft 自己的 Graph MCP 产品线尚未推出独立的 SharePoint 服务；当时的社区方案要么跳过了 SharePoint 在跨租户场景下所需的增量授权流程，要么将 SharePoint 视为独立的登录入口——每个连接器都要单独进行 OAuth 授权，并各自存储一份刷新令牌。我们将 MindstoneRebel 中打包的连接器提取出来，按原样移植，以便同一组包含五个连接器的 Microsoft 365 协作组（邮件、日历、文件、Teams、SharePoint）可以共用一套凭据和一个用于令牌持久化及请求超时处理的共享库。SharePoint 声明了自己的 authenticate_sharepoint 工具，与协作组的 authenticate_microsoft_account 相互独立，因此主机可以请求额外的 Sites.Read.All 权限范围，而不影响现有的邮件、日历、文件和 Teams 会话。

交互示例

“在 Strategy 团队的站点中查找 Q3 OKR 文档，并创建一个全团队可用的只读共享链接。”

主机调用的工具：

1. search_sharepoint — 在 Strategy 站点范围内搜索 Q3 OKR，并返回匹配的项目。
2. create_sharing_link — 为该项目创建组织范围内的只读共享链接。

响应（节选）：

{
  "match": {
    "siteId": "example.sharepoint.com,...",
    "name": "Q3-OKRs.docx",
    "webUrl": "https://example.sharepoint.com/sites/Strategy/..."
  },
  "share": {
    "type": "view",
    "scope": "organization",
    "webUrl": "https://example.sharepoint.com/:w:/r/sites/Strategy/.../EZk..."
  }
}

要求

• Node.js 20+
• npm
• 能够执行 Microsoft OAuth 流程，并将每个帐户的令牌文件写入 ${MS_CONFIG_DIR}/credentials/${sanitised-email}.token.json，同时写入 ${MS_CONFIG_DIR}/accounts.json 索引的主机应用程序。此服务会读取这些文件；它本身不会发起 OAuth 流程。

一键安装

点击按钮后，宿主会提示你填写：MS_CLIENT_ID、MS_CONFIG_DIR、MS_MCP_PACKAGE_ID、MICROSOFT_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Microsoft 365 SharePoint": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-microsoft-sharepoint"
      ],
      "env": {
        "MS_CLIENT_ID": "",
        "MS_CONFIG_DIR": "",
        "MS_MCP_PACKAGE_ID": "Microsoft365SharePoint",
        "MICROSOFT_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

快速开始

安装与构建

cd <path-to-repo>/connectors/microsoft-sharepoint
npm install
npm run build

npx（发布后）

npx -y @mindstone/mcp-server-microsoft-sharepoint

本地

node dist/index.js

配置

此服务与负责 Microsoft 365 OAuth 流程的宿主应用程序协同运行。宿主将凭据写入磁盘；此服务读取这些凭据。

必需的环境变量

可选的环境变量

宿主配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Microsoft365SharePoint": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-microsoft-sharepoint"],
      "env": {
        "MS_CLIENT_ID": "your-entra-application-client-id",
        "MS_CONFIG_DIR": "/absolute/path/to/microsoft-config"
      }
    }
  }
}

先通过 @mindstone/mcp-server-microsoft-mail 的 authenticate_microsoft_account 登录，以协商基础会话，然后调用此服务的 authenticate_sharepoint，在此基础上请求额外的 SharePoint Sites.Read.All 范围。

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "Microsoft365SharePoint": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/microsoft-sharepoint/dist/index.js"],
      "env": {
        "MS_CLIENT_ID": "your-entra-application-client-id",
        "MS_CONFIG_DIR": "/absolute/path/to/microsoft-config"
      }
    }
  }
}

工具（46）

安全注意事项

• authenticate_sharepoint 是 SharePoint 专用的增量式同意设置工具；该工具组其余工具的基础身份验证由 @mindstone/mcp-server-microsoft-mail 的 authenticate_microsoft_account 提供。
• 手动错误负载包含 action_required 和 next_step 恢复字段，同时保留现有的 auth_required 和成功响应结构。
• 已移除捆绑的 SharePoint 页面内容静默回退机制——现在处理程序错误会显示实际故障，而不会返回过时的页面正文。
• 每个工具的 Graph 调用都会通过 .options({signal}) 使用由调用方和工具组超时信号组合而成的信号。

许可证

FSL-1.1-MIT — Functional Source License 1.1 版，附带 MIT 未来许可证。允许免费用于非竞争用途；到达 LICENSE 中的转换日期后，将重新授权为 MIT。