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：将新文档上传到指定文件夹
• Update_Document：更新现有文档的内容
• Delete_Document：从指定文件夹中移除文档
• Delete_Folder：删除SharePoint中的空文件夹

架构

该服务器的设计考虑了资源效率：

• 通过选择性属性加载高效使用SharePoint API
• 通过装饰器处理错误以保持代码整洁
• 资源管理和工具实现之间有清晰的分离
• 针对文本和二进制文件优化内容处理

设置

1. 在Azure AD中注册一个具有适当SharePoint权限的应用程序
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

快速开始

安装

bash
pip install -e .

或者一旦发布后从PyPI安装：

bash
pip install mcp-sharepoint-server

使用uv：

bash
uv pip install mcp-sharepoint-server

Claude桌面集成

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

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

标准集成

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": "Shared Documents/your-folder",
"SHP_TENANT_ID": "your-tenant-id"
}
}
}

使用uvx

json
"mcpServers": {
"sharepoint": {
"command": "uvx",
"args": [
"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": "Shared Documents/your-folder",
"SHP_TENANT_ID": "your-tenant-id"
}
}
}

开发

要求

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

本地开发

1. 克隆仓库

2. 创建虚拟环境：
   bash
   python -m venv .venv
   source .venv/bin/activate # 在Windows上：.venvScriptsactivate

3. 安装开发依赖项：
   bash
   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-id5. 运行服务器：
   bash
   python -m mcp_sharepoint

调试

对于MCP服务器的调试，您可以使用MCP Inspector：

bash
npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

许可证

本项目采用MIT许可证授权 - 详情请参阅LICENSE文件。

版权所有 (c) 2025 sofias tech