Servidor MCP de SharePoint

Un servidor MCP lleuger per a una integració perfecta amb Microsoft SharePoint, que permet als clients MCP interactuar amb documents, carpetes i altres recursos de SharePoint. Desenvolupat per sofias tech.

Funcionalitats

Aquest servidor ofereix una interfície neta als recursos de SharePoint a través del Model Context Protocol (MCP), amb operacions optimitzades per a la gestió de documents.

Eines

El servidor implementa les següents eines:

List_SharePoint_Folders: Llista totes les carpetes d'un directori o arrel especificat
List_SharePoint_Documents: Recupera tots els documents dins d'una carpeta especificada
Get_Document_Content: Recupera el contingut d'un document (com a text o binari codificat en base64)
Create_Folder: Crea una nova carpeta al directori o arrel especificat
Upload_Document: Penja un nou document a una carpeta especificada
Upload_Document: Penja documents grans des d'un camí
Update_Document: Actualitza el contingut d'un document existent
Delete_Document: Elimina un document d'una carpeta especificada
Delete_Folder: Elimina una carpeta buida de SharePoint

Arquitectura

El servidor està construït amb l'eficiència de recursos en ment:

Ús eficient de l'API de SharePoint amb càrrega selectiva de propietats
Gestió d'errors mitjançant decoradors per a un codi més net
Separació clara entre la gestió de recursos i la implementació d'eines
Gestió optimitzada de contingut tant per a arxius de text com binaris

Configuració

Registra una aplicació a Azure AD amb els permisos adequats de SharePoint
Obtén l'ID de client i el secret de client per a l'aplicació registrada
Identifica l'URL del teu lloc SharePoint i el camí de la biblioteca de documents amb el que vols treballar

Variables d'Entorn

El servidor requereix les següents variables d'entorn:

SHP_ID_APP: El teu ID de client de l'aplicació Azure AD
SHP_ID_APP_SECRET: El teu secret de client de l'aplicació Azure AD
SHP_SITE_URL: L'URL del teu lloc SharePoint
SHP_DOC_LIBRARY: Camí a la biblioteca de documents (per defecte: "Shared Documents/mcp_server")
SHP_TENANT_ID: El teu ID de tenant de Microsoft

Inici ràpid

Instal·lació

pip install -e .

O instal·la des de PyPI un cop publicat:

pip install mcp-sharepoint-server

Utilitzant uv:

uv pip install mcp-sharepoint-server

Integració amb Claude Desktop

Per integrar amb Claude Desktop, actualitza el fitxer de configuració:

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

Integració estàndard

"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"
    }
  }
}

Usant uvx

"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"
    }
  }
}

Desenvolupament

Requisits

Python 3.10+
Dependències llistades a requirements.txt i pyproject.toml

Desenvolupament local

Clona el repositori

Crea un entorn virtual:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

Instal·la les dependències de desenvolupament:
```
pip install -e .
```

Crea un fitxer .env amb les teves credencials de SharePoint:

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

Executa el servidor:
```
python -m mcp_sharepoint
```

Depuració

Per depurar el servidor MCP, pots utilitzar l'MCP Inspector:

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

Llicència

Este projecte està llicenciat sota la Llicència MIT - consulta el fitxer LICENSE per a més detalls.