Servidor MCP SharePoint

Un servidor MCP ligero para una integración perfecta con Microsoft SharePoint, que permite a los clientes MCP interactuar con documentos, carpetas y otros recursos de SharePoint. Desarrollado por sofias tech.

Características

Este servidor proporciona una interfaz limpia a los recursos de SharePoint a través del Protocolo de Contexto de Modelo (MCP), con operaciones optimizadas para la gestión de documentos.

Herramientas

El servidor implementa las siguientes herramientas:

• List_SharePoint_Folders: Lista todas las carpetas de un directorio o raíz especificado
• Lista_Documentos_SharePoint: Obtiene todos los documentos de una carpeta especificada
• Obtener_contenido_del_documento: Recupera el contenido de un documento (como texto o binario codificado en base64)
• Crear_carpeta: Crea una nueva carpeta en el directorio o raíz especificado
• Subir_documento: Sube un nuevo documento a la carpeta especificada
• Cargar_documento: Sube documentos grandes desde la ruta.
• Actualizar_Documento: Actualiza el contenido de un documento existente
• Eliminar_Documento: Elimina un documento de una carpeta especificada
• Eliminar_Carpeta: Elimina una carpeta vacía de SharePoint

Arquitectura

El servidor se ha construido teniendo en cuenta la eficiencia de los recursos:

• Uso eficiente de la API de SharePoint con carga selectiva de propiedades
• Gestión de errores mediante decoradores para un código más limpio
• Clara separación entre la gestión de recursos y la implementación de herramientas
• Gestión de contenidos optimizada para archivos de texto y binarios

Configuración

1. Registrar una aplicación en Azure AD con los permisos adecuados de SharePoint
2. Obtenga el ID de cliente y el secreto de cliente para la aplicación registrada
3. Identifique la URL de su sitio SharePoint y la ruta de la biblioteca de documentos con la que desea trabajar

Variables de entorno

El servidor requiere estas variables de entorno:

• SHP_ID_APP: Su ID de cliente de la aplicación Azure AD
• SHP_ID_APP_SECRET: Su secreto de cliente de aplicación Azure AD
• SHP_SITE_URL: La URL de su sitio SharePoint
• SHP_DOC_LIBRARY: Ruta a la biblioteca de documentos (por defecto: "Shared Documents/mcp_server")
• SHP_TENANT_ID: Su ID de inquilino de Microsoft

Inicio rápido

Instalación

pip install -e

O instale desde PyPI una vez publicado:

pip install mcp-sharepoint-server

Usando uv:

uv pip install mcp-sharepoint-server

Integración con Claude Desktop

Para integrar con Claude Desktop, actualice el archivo de configuración:

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

Integración estándar

"mcpServers": { "sharepoint": { "command": "mcp-sharepoint", "env": { "SHP_ID_APP": "tu-app-id", "SHP_ID_APP_SECRET": "your-app-secret", "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site", "SHP_DOC_LIBRARY": "Documentos compartidos/tu-carpeta", "SHP_TENANT_ID": "your-tenant-id" } }

Uso de uvx

"mcpServers": { "sharepoint": { "command": "uvx", "args": [ "mcp-sharepoint" ], "env": { "SHP_ID_APP": "tu-app-id", "SHP_ID_APP_SECRET": "your-app-secret", "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site", "SHP_DOC_LIBRARY": "Documentos compartidos/tu-carpeta", "SHP_TENANT_ID": "your-tenant-id" } }

Desarrollo

Requisitos

• Python 3.10+
• Dependencias listadas en requirements.txt y pyproject.toml

Desarrollo local

1. Clonar el repositorio
2. Crear un entorno virtual:

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

3. Instalar las dependencias de desarrollo:

   pip install -e

4. Cree un archivo .env con sus credenciales de SharePoint:

   SHP_ID_APP=su-app-id SHP_ID_APP_SECRET=su-app-secret SHP_SITE_URL=https://your-tenant.sharepoint.com/sites/your-site SHP_DOC_LIBRARY=Documentos compartidos/su-carpeta SHP_TENANT_ID=su-tenant-id

5. Ejecute el servidor:

   python -m mcp_sharepoint

Depuración

Para depurar el servidor MCP, puede utilizar el Inspector MCP:

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

Copyright (c) 2025 sofias tech