Server Sharepoint

🚀 SharePoint Online MCP Server

SharePoint Online MCP Server 是一款功能强大的服务器，它能够借助 SharePoint REST API 与 SharePoint Online 实现无缝交互。该服务器专为与 Claude Desktop 应用搭配使用而设计，但也可被其他 MCP 客户端（如 Cline）使用。

🚀 快速开始

若要使用 SharePoint Online MCP Server，需按照以下步骤操作：

1. 完成身份验证配置（包含客户端密钥验证或证书验证）。
2. 安装 Node.js（版本 22.14.0 或更高）。
3. 安装并配置 Claude Desktop。
4. 开始与 MCP 服务器进行交互。

✨ 主要特性

• 强大的交互能力：借助 SharePoint REST API，实现与 SharePoint Online 的无缝交互。
• 多客户端支持：不仅能与 Claude Desktop 搭配使用，还能被其他 MCP 客户端（如 Cline）使用。
• 多种身份验证方式：支持客户端密钥验证和证书验证两种方式。

📦 安装指南

安装 Node.js

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

安装并配置 Claude Desktop

1. 下载 Claude Desktop 并进行安装。
2. 在 Claude Desktop 中，依次点击 File > Settings > Developer。
3. 点击 Edit Config。
4. 在编辑器中打开 claude_desktop_config.json 配置文件。你也可以使用之前 PowerShell 脚本生成的 claude_desktop_config.json 文件。
5. 将以下内容粘贴到配置中，并根据自身情况更新 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

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

💻 使用示例

基础用法

在 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。

📚 详细文档

SharePoint 操作可用性

用户操作

网站操作

区域设置操作

功能操作

列表操作

列表视图操作

列表内容类型操作

列表项操作

网站内容类型操作

页面操作

文档操作

分类操作

搜索操作

身份验证选项

服务器支持两种身份验证方法：

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

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

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

配置步骤

⚠️ 重要提示

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

允许仅 SharePoint 应用

• 从 此处 下载并安装 SharePoint Online Management Shell。
• 打开 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，并以全局管理员身份登录，以授予权限同意。

贡献者指南

构建新的 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 许可证，详情请见 LICENSE 文件。