PyPI version Total Downloads License: MIT Install MCP Server

Сервер протокола контекста модели (MCP), который позволяет манипулировать файлами Excel без необходимости установки Microsoft Excel. Создавайте, читайте и изменяйте рабочие книги Excel с помощью вашего ИИ-агента.

Функции

📊 Операции с Excel: создание, чтение и обновление рабочих книг и листов
📈 Манипуляция данными: формулы, форматирование, диаграммы, сводные таблицы и таблицы Excel
🔍 Проверка данных: встроенная проверка диапазонов, формул и целостности данных
🎨 Форматирование: стили шрифтов, цвета, границы, выравнивание и условное форматирование
📋 Операции с таблицами: создание и управление таблицами Excel с пользовательским стилем
📊 Создание диаграмм: генерация различных типов диаграмм (линейные, столбчатые, круговые, точечные и т. д.)
🔄 Сводные таблицы: создание динамических сводных таблиц для анализа данных
🔧 Управление листами: легкое копирование, переименование и удаление рабочих листов
🔌 Поддержка трех видов транспорта: stdio, SSE (устаревший) и потоковый HTTP
🌐 Удаленная и локальная работа: работает как локально, так и в качестве удаленного сервиса

Related MCP server: Excel MCP Server

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

Сервер поддерживает три метода транспорта:

1. Транспорт Stdio (для локального использования)

uvx excel-mcp-server stdio

{
   "mcpServers": {
      "excel": {
         "command": "uvx",
         "args": ["excel-mcp-server", "stdio"]
      }
   }
}

2. Транспорт SSE (Server-Sent Events — устаревший)

uvx excel-mcp-server sse

Подключение через транспорт SSE:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/sse",
      }
   }
}

3. Потоковый HTTP-транспорт (рекомендуется для удаленных подключений)

uvx excel-mcp-server streamable-http

Подключение через потоковый HTTP-транспорт:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/mcp",
      }
   }
}

Переменные окружения и обработка путей к файлам

Транспорты SSE и потоковый HTTP

При запуске сервера с использованием протоколов SSE или потокового HTTP, вы должны установить переменную окружения EXCEL_FILES_PATH на стороне сервера. Эта переменная указывает серверу, где читать и записывать файлы Excel.

Если она не установлена, по умолчанию используется ./excel_files.
При использовании этих транспортов значения filepath для инструментов должны быть относительными по отношению к этой директории (например, reports/q1.xlsx); абсолютные пути и переходы по директориям отклоняются.

Вы также можете установить переменную окружения FASTMCP_PORT, чтобы управлять портом, на котором прослушивает сервер (по умолчанию 8017, если не задано).

Пример (Windows PowerShell):

$env:EXCEL_FILES_PATH="E:\MyExcelFiles"
$env:FASTMCP_PORT="8007"
uvx excel-mcp-server streamable-http

Пример (Linux/macOS):

EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http

Транспорт Stdio

При использовании протокола stdio путь к файлу предоставляется при каждом вызове инструмента, поэтому вам не нужно устанавливать EXCEL_FILES_PATH на сервере. Сервер будет использовать путь, отправленный клиентом для каждой операции.