Servidor MCP de SharePoint

Un servidor MCP ligero que se integra perfectamente con Microsoft SharePoint, lo 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 : enumera todas las carpetas en un directorio o raíz especificado

• List_SharePoint_Documents : recupera todos los documentos dentro de una carpeta específica

• Get_Document_Content : recupera el contenido de un documento (como texto o binario codificado en base64)

• Create_Folder : Crea una nueva carpeta en el directorio o raíz especificado

• Upload_Document : carga un nuevo documento en una carpeta específica

• Upload_Document : carga documentos grandes desde la ruta.

• Update_Document : actualiza el contenido de un documento existente

• Delete_Document : elimina un documento de una carpeta específica

• Delete_Folder : elimina una carpeta vacía de SharePoint

Related MCP server: MCP Server

Arquitectura

El servidor está construido teniendo en cuenta la eficiencia de los recursos:

• Uso eficiente de la API de SharePoint con carga selectiva de propiedades

• Manejo de errores mediante decoradores para un código más limpio

• Separación clara entre la gestión de recursos y la implementación de herramientas

• Manejo de contenido optimizado tanto para archivos de texto como binarios

Configuración

1. Registrar una aplicación en Azure AD con los permisos de SharePoint adecuados

2. Obtenga el ID del cliente y el secreto del cliente para la aplicación registrada

3. Identifique la URL de su sitio de 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 identificador de cliente de la aplicación de Azure AD

• SHP_ID_APP_SECRET : Su secreto de cliente de la aplicación de Azure AD

• SHP_SITE_URL : La URL de su sitio de SharePoint

• SHP_DOC_LIBRARY : Ruta a la biblioteca de documentos (predeterminado: "Documentos compartidos/mcp_server")

• SHP_TENANT_ID : Su ID de inquilino de Microsoft

Inicio rápido

Instalación

O instalar desde PyPI una vez publicado:

Usando uv:

Integración de escritorio de Claude

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

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

Integración estándar

Uso de uvx

Desarrollo

Requisitos

• Python 3.10+

• Dependencias enumeradas 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 # On Windows: .venv\Scripts\activate

3. Instalar dependencias de desarrollo:

   pip install -e .

4. Cree un archivo .env con sus credenciales 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

5. Ejecutar el servidor:

   python -m mcp_sharepoint

Depuración

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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Copyright (c) 2025 sofias tech