AI导哈

SharePoint文档管理工具

一个用于Microsoft SharePoint的文档管理工具，支持通过Azure AD（MSAL）进行身份验证，提供文件上传、下载、编辑等功能。

  • by mdev26
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mdev26/mcp-sharepoint-us

使用说明

SharePoint MCP服务器

用于Microsoft SharePoint的MCP服务器，使用现代Azure AD（SCL）身份验证。

先决条件

Azure AD应用程序注册

  1. 首选 Azure 门户 → Azure Active Directory → 应用程序注册 → 新注册

    • 名字：你喜欢什么都行
    • 支持的帐户类型：“仅此组织目录中的帐户”
    • 重定向URI：留空

  2. 从 概述 第页，注意：

    • 应用程序（客户端）ID → SHP_ID_APP
    • 目录（租户）ID → SHP_TENANT_ID

  3. 证书和秘密 → 新客户机密

    • 保存 价值 立即（你不会再看到它了）→ SHP_ID_APP_SECRET

  4. API权限 → 添加权限 → SharePoint → 应用权限

    • 添加 Sites.ReadWrite.All （或 Sites.Read.All 只读）
    • 点击 授予管理员同意 --状态必须显示绿色复选标记

  5. 获取您的SharePoint网站URL（例如。 https://contoso.sharepoint.com/sites/yoursite) → SHP_SITE_URL

    • 不要包含尾随斜线

安全最佳实践

  • 使用 Sites.Read.All 如果你只需要读取权限（最小权限原则）
  • 设置日历提醒，在到期前轮换客户端机密
  • 永不承诺 .env 文件到Git——使用环境变量或机密管理器

安装

pip install mcp-sharepoint-us

或来源：

git clone https://github.com/mdev26/mcp-sharepoint-us.git
cd mcp-sharepoint-us
pip install -e .

配置

# Required
SHP_TENANT_ID=your-tenant-id-guid
SHP_ID_APP=your-client-id-guid
SHP_ID_APP_SECRET=your-client-secret
SHP_SITE_URL=https://your-tenant.sharepoint.com/sites/your-site

# Optional
SHP_DOC_LIBRARY=Shared Documents   # default
SHP_AUTH_METHOD=msal               # options: msal (default), certificate, legacy

基于证书的身份验证（可选）

SHP_AUTH_METHOD=certificate
SHP_CERT_PATH=/path/to/certificate.pem
SHP_CERT_THUMBPRINT=your-cert-thumbprint

Claude桌面集成

窗户： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sharepoint": {
      "command": "python",
      "args": ["-m", "mcp_sharepoint"],
      "env": {
        "SHP_TENANT_ID": "your-tenant-id",
        "SHP_ID_APP": "your-client-id",
        "SHP_ID_APP_SECRET": "your-client-secret",
        "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
        "SHP_AUTH_METHOD": "msal"
      }
    }
  }
}

使用uvx

{
  "mcpServers": {
    "sharepoint": {
      "command": "uvx",
      "args": ["mcp-sharepoint-us"],
      "env": {
        "SHP_TENANT_ID": "your-tenant-id",
        "SHP_ID_APP": "your-client-id",
        "SHP_ID_APP_SECRET": "your-client-secret",
        "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site"
      }
    }
  }
}

可用工具

工具 说明
Test_Connection 验证身份验证和连接
List_SharePoint_Documents 列出文件夹中的文档
Get_Document_Content 读取文档内容（支持.docx、.pptx、.xlsx、.pdf）
Upload_Document 上传新文档
Update_Document 更新现有文档
Delete_Document 删除文档
List_SharePoint_Folders 列出文件夹
Create_Folder 创建新文件夹
Delete_Folder 删除空文件夹
Get_SharePoint_Tree 获取递归文件夹结构
Create_Word_Document 创建格式化的.docx并上传到SharePoint
Edit_Word_Document 在.docx中查找/替换或部分替换内容
Create_PowerPoint 创建.pptx并上传到SharePoint

故障排除

启用调试日志

LOGLEVEL=DEBUG python -m mcp_sharepoint

“获取仅应用程序访问令牌失败”

  • 确保 SHP_TENANT_ID 已设置且正确（Azure门户→ Azure Active Directory→ 概述→ 租户ID）
  • 确保 SHP_AUTH_METHOD=msal （或保持未设置状态——默认值为msal）
  • 验证Azure门户中是否授予管理员同意（API权限上的绿色复选标记）
  • 授予权限后，等待5-10分钟进行传播

“403禁止”/“拒绝访问”

  • 权限必须 应用 权限，未委托
  • 必须获得管理员同意
  • 网站URL必须与SharePoint网站完全匹配（无尾随斜线）

“客户端密码无效”

  • 复制秘密 价值，而不是秘密ID
  • 检查您的电脑中是否有多余的空间 .env 文件
  • 密码可能已过期，请创建一个新密码

连接重置/防火墙问题

如果身份验证成功但Graph API调用失败（TLS期间连接重置），则端点 graph.microsoft.us （美国政府）或 graph.microsoft.com （商业）可能会被使用深度数据包检测的防火墙阻止。请您的网络团队将端口443上的端点列入白名单。对于代理环境：

export HTTPS_PROXY=http://proxy.company.com:8080

许可证

MIT许可证

相关 MCP