SharePoint MCP-сервер

Легкий MCP-сервер для бесшовной интеграции с Microsoft SharePoint, позволяющий клиентам MCP взаимодействовать с документами, папками и другими ресурсами SharePoint. Разработано sofias tech .

Функции

Этот сервер обеспечивает понятный интерфейс к ресурсам SharePoint через протокол контекста модели (MCP) с оптимизированными операциями для управления документами.

Инструменты

На сервере реализованы следующие инструменты:

• List_SharePoint_Folders : выводит список всех папок в указанном каталоге или корневом каталоге.

• List_SharePoint_Documents : извлекает все документы из указанной папки.

• Get_Document_Content : извлекает содержимое документа (в виде текста или двоичного файла в кодировке base64)

• Create_Folder : создает новую папку в указанном каталоге или корне.

• Upload_Document : загружает новый документ в указанную папку.

• Upload_Document : Загружает большие документы из указанного пути.

• Update_Document : обновляет содержимое существующего документа.

• Delete_Document : удаляет документ из указанной папки.

• Delete_Folder : удаляет пустую папку из SharePoint.

Related MCP server: MCP Server

Архитектура

Сервер создан с учетом эффективности использования ресурсов:

• Эффективное использование API SharePoint с выборочной загрузкой свойств

• Обработка ошибок с помощью декораторов для более чистого кода

• Четкое разделение между управлением ресурсами и внедрением инструментов

• Оптимизированная обработка содержимого как текстовых, так и двоичных файлов.

Настраивать

1. Зарегистрируйте приложение в Azure AD с соответствующими разрешениями SharePoint.

2. Получите идентификатор клиента и секретный ключ клиента для зарегистрированного приложения.

3. Определите URL-адрес вашего сайта SharePoint и путь к библиотеке документов, с которой вы хотите работать.

Переменные среды

Серверу требуются следующие переменные среды:

• SHP_ID_APP : идентификатор клиента вашего приложения Azure AD

• SHP_ID_APP_SECRET : Секрет клиента вашего приложения Azure AD

• SHP_SITE_URL : URL вашего сайта SharePoint

• SHP_DOC_LIBRARY : Путь к библиотеке документов (по умолчанию: «Shared Documents/mcp_server»)

• SHP_TENANT_ID : Ваш идентификатор клиента Microsoft

Быстрый старт

Установка

Или установите из PyPI после публикации:

Использование УФ:

Интеграция рабочего стола Клода

Для интеграции с Claude Desktop обновите файл конфигурации:

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

Стандартная интеграция

Использование UVX

Разработка

Требования

• Питон 3.10+

• Зависимости, перечисленные в requirements.txt и pyproject.toml

Местное развитие

1. Клонировать репозиторий

2. Создайте виртуальную среду:

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

3. Установка зависимостей разработки:

   pip install -e .

4. Создайте файл .env с вашими учетными данными 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. Запустите сервер:

   python -m mcp_sharepoint

Отладка

Для отладки сервера MCP вы можете использовать MCP Inspector :

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Copyright (c) 2025 г. Софиас Тех