SharePoint MCP Server

SharePoint MCP 服务器

轻量级 MCP 服务器，可与 Microsoft SharePoint 无缝集成，使 MCP 客户端能够与文档、文件夹和其他 SharePoint 资源进行交互。由sofias tech开发。

特征

该服务器通过模型上下文协议 (MCP) 为 SharePoint 资源提供干净的接口，并针对文档管理进行优化操作。

工具

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

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

建筑学

该服务器的构建充分考虑了资源效率：

• 通过选择性属性加载实现高效的 SharePoint API 使用
• 通过装饰器进行错误处理以获得更清晰的代码
• 资源管理和工具实施之间的明确分离
• 优化文本和二进制文件的内容处理

设置

1. 使用适当的 SharePoint 权限在 Azure AD 中注册应用程序
2. 获取已注册应用的客户端 ID 和客户端密钥
3. 确定您的 SharePoint 网站 URL 和要使用的文档库路径

环境变量

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

• SHP_ID_APP ：您的 Azure AD 应用程序客户端 ID
• SHP_ID_APP_SECRET ：您的 Azure AD 应用程序客户端机密
• SHP_SITE_URL ：您的 SharePoint 站点的 URL
• SHP_DOC_LIBRARY ：文档库的路径（默认值：“Shared Documents/mcp_server”）
• SHP_TENANT_ID ：您的 Microsoft 租户 ID

快速入门

安装

或者发布后从 PyPI 安装：

使用紫外线：

Claude 桌面集成

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

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

标准集成

使用 uvx

发展

要求

• Python 3.10+
• requirements.txt和pyproject.toml中列出的依赖项

本地开发

1. 克隆存储库
2. 创建虚拟环境：
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 安装开发依赖项：
   pip install -e .
4. 使用您的 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=Shared Documents/your-folder SHP_TENANT_ID=your-tenant-id
5. 运行服务器：
   python -m mcp_sharepoint

调试

要调试 MCP 服务器，您可以使用MCP 检查器：

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

版权所有 (c) 2025 索菲亚斯科技