🚀 Microsoft SharePoint MCP 服务器

一个轻量级的MCP服务器，用于与Microsoft SharePoint实现无缝集成。借助该服务器，MCP客户端能够与文档、文件夹以及其他SharePoint资源进行交互。此项目由sofias tech开发。

🚀 快速开始

安装

pip install -e .

或者在发布到PyPI后安装：

pip install mcp-sharepoint-server

使用uv:

uv pip install mcp-sharepoint-server

Claude桌面集成

要与Claude Desktop集成，需更新配置文件：

• 在Windows上: %APPDATA%/Claude/claude_desktop_config.json
• 在macOS上: ~/Library/Application\ Support/Claude/claude_desktop_config.json

标准集成

"mcpServers": {
  "sharepoint": {
    "command": "mcp-sharepoint",
    "env": {
      "SHP_ID_APP": "your-app-id",
      "SHP_ID_APP_SECRET": "your-app-secret",
      "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
      "SHP_DOC_LIBRARY": "Documents"
    }
  }
}

高级配置

您还能通过以下环境变量进行额外配置：

• SHP_API_VERSION：指定使用的SharePoint API版本（默认: "v1.0"）
• SHP_AUTH_TYPE：指定身份验证类型（支持"AzureAD"和"Guest"，默认: "AzureAD"）

✨ 主要特性

此服务器通过Model Context Protocol (MCP) 提供对SharePoint资源的简洁接口，并针对文档管理进行了操作优化。

工具

该服务器实现了以下工具：

• List_SharePoint_Folders：列出指定目录或根目录下的所有文件夹
• List_SharePoint_Documents：获取指定文件夹内的所有文档
• Get_Document_Content：检索文档的内容（作为文本或Base64编码的二进制）
• Create_Folder：在指定目录或根目录下创建新文件夹
• Upload_Document：上传新文档到指定文件夹
• Update_Document：更新现有文档的内容
• Delete_Document：从指定文件夹中删除文档
• Delete_Folder：删除空的SharePoint文件夹

🔧 技术细节

该服务器以资源效率为设计理念：

• 通过选择性属性加载高效使用SharePoint API
• 使用装饰器实现简洁的错误处理
• 清晰区分资源管理和工具实现
• 针对文本和二进制文件的内容处理进行了优化

📦 安装指南

1. 在Azure AD中注册一个具有适当SharePoint权限的应用程序
2. 获取注册应用的客户端ID和客户端秘密
3. 确定您的SharePoint站点URL以及要操作的文档库路径

环境变量

服务器需要以下环境变量：

💻 使用示例

开发

安装依赖项

使用pip安装所需库：

pip install -r requirements.txt

本地开发

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-sharepoint.git
cd mcp-sharepoint

2. 安装依赖项（如上所述）
3. 运行服务器：

python -m mcp_sharepoint

📄 许可证

此项目根据MIT License授权，详情请参阅LICENSE文件。

版权所有 (c) 2025 sofias tech