Server Sharepoint

🚀 SharePoint Online MCP Server

最强大的 SharePoint MCP 服务器，可通过 SharePoint REST API 与 SharePoint Online 进行无缝交互。该 MCP 服务器专为与 Claude Desktop 应用程序配合使用而设计，但也可由其他 MCP 客户端（如 Cline）使用。

🚀 快速开始

本项目是一个强大的 SharePoint MCP 服务器，能借助 SharePoint REST API 与 SharePoint Online 实现无缝交互。以下将详细介绍如何使用该服务器。

✨ 主要特性

• 支持通过 SharePoint REST API 与 SharePoint Online 进行无缝交互。
• 可与 Claude Desktop 应用配合使用，也支持其他 MCP 客户端。
• 提供两种认证方式：客户端密钥认证和证书认证。

📦 安装指南

安装 Node.js

安装 Node.js 版本：22.14.0 或更高版本

安装并配置 Claude Desktop

• 下载 Claude Desktop 并进行安装。
• 在 Claude Desktop 中，依次点击 File > Settings > Developer。
• 点击 Edit Config。
• 在编辑器中打开 claude_desktop_config.json 配置文件，也可使用之前 PowerShell 脚本生成的 claude_desktop_config.json 文件。
• 将以下内容粘贴到配置中，并使用你自己的值更新 mcpServers 部分：

证书认证配置

{
  "mcpServers": {
    "server-sharepoint": {
      "command": "npx",
      "args": [
        "-y",
        "server-sharepoint"
      ],
      "env": {
        "AZURE_APPLICATION_ID": "<your-app-id>",
        "AZURE_APPLICATION_CERTIFICATE_THUMBPRINT": "<your-certificate-thumbprint>",
        "AZURE_APPLICATION_CERTIFICATE_PASSWORD": "<your-certificate-password>",
        "M365_TENANT_ID": "<your-tenant-id>"
      }
    }
  }
} 

客户端密钥认证配置（不推荐）

{
  "mcpServers": {
    "server-sharepoint": {
      "command": "npx",
      "args": [
        "-y",
        "server-sharepoint"
      ],
      "env": {
        "SHAREPOINT_CLIENT_ID": "<your-client-id>",
        "SHAREPOINT_CLIENT_SECRET": "<your-client-secret>",
        "M365_TENANT_ID": "<your-tenant-id>"
      }
    }
  }
} 

💡了解如何从 Entra ID 获取租户 ID

• 保存配置文件并重启 Claude Desktop。确保通过任务栏图标完全退出应用程序：

📚 详细文档

SharePoint 操作可用性

用户操作

网站操作

区域设置操作

功能操作

列表操作

列表视图操作

列表内容类型操作

列表项操作

网站内容类型操作

页面操作

文档操作

分类操作

搜索操作

认证选项

服务器支持两种认证方式：

1. 客户端密钥认证 - 传统的客户端 ID 和密钥。这是仅应用程序认证方式，已弃用，2026 年 4 月后将无法使用。
2. 证书认证 - 更现代的方法，使用带有证书的 Azure AD 应用注册。

选项 1：客户端密钥认证（2026 年 4 月后将无法使用）

此选项需要 SharePoint 管理员角色。

配置步骤

⚠️ 重要提示

你需要是 SharePoint 租户管理员或全局管理员才能创建 SharePoint 应用程序。

允许仅 SharePoint 应用程序

• 从 此处 下载并安装 SharePoint Online 管理外壳。
• 打开 PowerShell 并运行以下命令，确保仅 SharePoint 应用程序已启用：

Connect-SPOService -Url https://<your-tenant>-admin.sharepoint.com/
Set-SPOTenant -DisableCustomAppAuthentication $false

使用客户端密钥创建仅 SharePoint 应用程序

• 打开 https://<your-tenant>.sharepoint.com/_layouts/15/appregnew.aspx
• 点击 Generate 以创建新的客户端 ID 和密钥。
• 填写以下字段：
  • 应用程序域：www.example.com（或你拥有的任何域名）
  • 重定向 URL：http://example.com
• 点击 Create 以创建应用程序。
• 将 Client ID 和 Client Secret 值复制到安全的地方，后续会用到。

授予应用程序权限

• 打开 https://<your-tenant>.sharepoint.com/_layouts/15/appinv.aspx
• 将 Client ID 值粘贴到 App ID 字段中，然后点击 Lookup。
• 将以下 XML 粘贴到 App Permission Request XML 字段中：

<AppPermissionRequests AllowAppOnlyPolicy="true">
   <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl" />
</AppPermissionRequests>

• 点击 Create，然后点击 Trust It 以授予应用程序权限。

选项 2：证书认证

基于证书的认证比客户端密钥提供更好的安全性。它使用证书来证明应用程序的身份，而不是共享密钥。

⚠️ 重要提示

此选项需要全局管理员角色才能为应用程序提供必要的权限。

克隆仓库

git clone https://github.com/Zerg00s/server-sharepoint.git

使用证书创建 Azure AD 应用程序

导航到克隆的仓库，并使用提供的 PowerShell 脚本创建带有证书的 Azure AD 应用程序：

.\Create-SPAppCertificate.ps1 -AppName "SharePoint-Server-MCP" -CertName "SharePoint-Server-MCP-Cert" -CertPassword "YourSecureP@ssw0rd!"

此脚本将：

1. 在你的证书存储中创建自签名证书。
2. 注册 Azure AD 应用程序。
3. 将证书添加到应用程序。
4. 配置所需的 SharePoint 权限。
5. 生成包含必要设置的配置文件。
6. 输出与 Claude Desktop 兼容的 claude_desktop_config.json。

授予管理员同意

运行脚本后，你将获得一个管理员同意 URL。在浏览器中打开该 URL，并以全局管理员身份登录以授予权限同意。

如何与 MCP 服务器“对话”

• 打开 Claude Desktop 并提出问题，例如 Get me the list of lists from https://<your-tenant>.sharepoint.com/sites/Dashboard-Communication. Present the results in a table form. don't use code。

🔧 技术细节

为贡献者提供的信息

构建新的 npm 包

npm run build
npm publish
npx clear-npx-cache
npm cache clean --force

本地运行 MCP 检查器

npx @modelcontextprotocol/inspector node build/src/index.js

MCP 服务器上下文 7 文档（适用于大语言模型）

MCP 服务器上下文 7 文档（适用于大语言模型）

SharePoint REST API 文档

• SharePoint REST API 文档
• 使用 SharePoint REST 端点完成基本操作
• /_vti_bin/client.svc/ProcessQuery 的请求 XML 架构

本地开发

• 克隆仓库
• nvm use 22.14.0
• npm install
• 更新 claude_desktop_config.json 文件中的 MCP 配置。示例如下：

客户端密钥认证（2026 年 4 月后将无法使用）

{
"mcpServers": {
  "sharepoint": {
      "command": "node",
      "args": [
        "C:\\trash\\server-sharepoint\\build\\index.js"
      ],
      "env": {
        "SHAREPOINT_CLIENT_ID": "aaa2ce0f-7c97-4e51-acd9-4ac99e6831d0",
        "SHAREPOINT_CLIENT_SECRET": "bbb0OFF+aWkua2NJRERUMGduMmhsWDhGUTVPUHJZLXd5dldSemNPUw==",
        "M365_TENANT_ID": "22bcd981-eaa6-475f-aac3-3afca0c35261"
      }
    }
  }
}

证书认证（推荐）

{
"mcpServers": {
  "sharepoint": {
      "command": "node",
      "args": [
        "C:\\trash\\server-sharepoint\\build\\index.js"
      ],
      "env": {
        "AZURE_APPLICATION_ID": "5bc793c7-3eb0-4b86-88bf-b464b2459c4c",
        "AZURE_APPLICATION_CERTIFICATE_THUMBPRINT": "3D38D1D8AC3228CAD35E527D1105101B0B90CE86",
        "AZURE_APPLICATION_CERTIFICATE_PASSWORD": "TemporaryP@ssw0rd",
        "M365_TENANT_ID": "11bcd981-eaa6-475f-aac3-3afca0c35261"
      }
    }
  }
}

• 对代码进行更改
• 构建代码 npm run build
• 使用 MCP 检查器进行测试：npx @modelcontextprotocol/inspector node build/src/index.js -y

📄 许可证

本项目采用 MIT 许可证。