SharePoint MCP-Server

Ein schlanker MCP-Server für die nahtlose Integration mit Microsoft SharePoint. Er ermöglicht MCP-Clients die Interaktion mit Dokumenten, Ordnern und anderen SharePoint-Ressourcen. Entwickelt von sofias tech .

Merkmale

Dieser Server bietet über das Model Context Protocol (MCP) eine saubere Schnittstelle zu SharePoint-Ressourcen mit optimierten Vorgängen für die Dokumentenverwaltung.

Werkzeuge

Der Server implementiert die folgenden Tools:

• List_SharePoint_Folders : Listet alle Ordner in einem angegebenen Verzeichnis oder Stammverzeichnis auf

• List_SharePoint_Documents : Ruft alle Dokumente in einem angegebenen Ordner ab

• Get_Document_Content : Ruft den Inhalt eines Dokuments ab (als Text oder Base64-codierte Binärdatei)

• Create_Folder : Erstellt einen neuen Ordner im angegebenen Verzeichnis oder Stammverzeichnis

• Upload_Document : Lädt ein neues Dokument in einen angegebenen Ordner hoch

• Upload_Document : Lädt große Dokumente vom Pfad hoch.

• Update_Document : Aktualisiert den Inhalt eines vorhandenen Dokuments

• Delete_Document : Entfernt ein Dokument aus einem angegebenen Ordner

• Delete_Folder : Löscht einen leeren Ordner aus SharePoint

Related MCP server: MCP Server

Architektur

Der Server wurde im Hinblick auf Ressourceneffizienz entwickelt:

• Effiziente SharePoint-API-Nutzung mit selektivem Laden von Eigenschaften

• Fehlerbehandlung durch Dekoratoren für saubereren Code

• Klare Trennung zwischen Ressourcenmanagement und Tool-Implementierung

• Optimierte Inhaltsverarbeitung für Text- und Binärdateien

Aufstellen

1. Registrieren einer App in Azure AD mit entsprechenden SharePoint-Berechtigungen

2. Abrufen der Client-ID und des Client-Geheimnisses für die registrierte App

3. Identifizieren Sie die URL Ihrer SharePoint-Site und den Pfad der Dokumentbibliothek, mit der Sie arbeiten möchten

Umgebungsvariablen

Der Server benötigt diese Umgebungsvariablen:

• SHP_ID_APP : Ihre Azure AD-Anwendungsclient-ID

• SHP_ID_APP_SECRET : Ihr Azure AD-Anwendungsclientgeheimnis

• SHP_SITE_URL : Die URL Ihrer SharePoint-Site

• SHP_DOC_LIBRARY : Pfad zur Dokumentbibliothek (Standard: „Shared Documents/mcp_server“)

• SHP_TENANT_ID : Ihre Microsoft-Mandanten-ID

Schnellstart

Installation

pip install -e .

Oder installieren Sie es nach der Veröffentlichung von PyPI:

pip install mcp-sharepoint-server

Verwenden von UV:

uv pip install mcp-sharepoint-server

Claude Desktop Integration

Aktualisieren Sie zur Integration mit Claude Desktop die Konfigurationsdatei:

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

Standardintegration

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

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

Entwicklung

Anforderungen

• Python 3.10+

• In requirements.txt und pyproject.toml aufgeführte Abhängigkeiten

Lokale Entwicklung

1. Klonen Sie das Repository

2. Erstellen Sie eine virtuelle Umgebung:

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

3. Installieren Sie Entwicklungsabhängigkeiten:

   pip install -e .

4. Erstellen Sie eine .env Datei mit Ihren SharePoint-Anmeldeinformationen:

   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. Führen Sie den Server aus:

   python -m mcp_sharepoint

Debuggen

Zum Debuggen des MCP-Servers können Sie den MCP Inspector verwenden:

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Copyright (c) 2025 sofias tech