金大哥 - mcp-sharepoint MCP 详情

article

README

🚀 微软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
使用装饰器实现简洁的错误处理
清晰区分资源管理和工具实现
针对文本和二进制文件的内容处理进行了优化

📦 安装指南

设置

在Azure AD中注册一个具有适当SharePoint权限的应用程序
获取注册应用的客户端ID和客户端秘密
确定您的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

💻 使用示例

开发

安装依赖项

使用pip安装所需库：

pip install -r requirements.txt

本地开发

克隆仓库：

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

安装依赖项（如上所述）
运行服务器：
```
python -m mcp_sharepoint
```

mcp-sharepoint