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

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

Установка

pip install -e .

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

pip install mcp-sharepoint-server

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

uv pip install mcp-sharepoint-server

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

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

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

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

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

Использование 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"
    }
  }
}

Разработка

Требования

• Питон 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 :

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

Лицензия

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

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