excel-mcp-server
by haris-musa (community) Claude Desktop, Claude Code
MCP-сервер для работы с Excel (.xlsx) файлами. Позволяет LLM читать, редактировать таблицы, создавать графики и форматировать данные без Excel. Возможности: - Чтение и запись ячеек, диапазонов, листов - Создание формул и именованных диапазонов - Построение диаграмм (bar, line, pie, scatter) - Форматирование: цвета, шрифты, границы - Создание новых .xlsx файлов - Работает без Microsoft Office (использует openpyxl)
# pip install excel-mcp-server
# Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"excel": {
"command": "uvx",
"args": ["excel-mcp-server"]
}
}
}
# Claude Code (CLI):
claude mcp add excel -- uvx excel-mcp-server
# OpenCode — ~/.config/opencode/opencode.json:
{
"mcp": {
"excel": {
"type": "local",
"command": ["uvx", "excel-mcp-server"]
}
}
}
Сервер моделирования контекста (MCP), который позволяет вам работать с файлами Excel без необходимости установки Microsoft Excel. Создавайте, читайте и изменяйте рабочие книги Excel с помощью вашего ИИ-агента.
Особенности
- 📊 Операции с Excel: Создание, чтение, обновление рабочих книг и листов
- 📈 Манипуляции с данными: Формулы, форматирование, диаграммы, сводные таблицы и таблицы Excel
- 🔍 Проверка данных: Встроенная проверка диапазонов, формул и целостности данных
- 🎨 Форматирование: Стили шрифтов, цвета, границы, выравнивание и условное форматирование
- 📋 Операции с таблицами: Создание и управление таблицами Excel с пользовательским стилем
- 📊 Создание диаграмм: Генерация различных типов диаграмм (линейные, столбчатые, круговые, точечные и т.д.)
- 🔄 Сводные таблицы: Создание динамичных сводных таблиц для анализа данных
- 🔧 Управление листами: Копирование, переименование и удаление рабочих листов
- 🔌 Тройная поддержка транспорта: stdio, SSE (устаревший) и потоковый HTTP
- 🌐 Удалённый и локальный: Работает как локально, так и в качестве удалённого сервиса
Использование
Сервер поддерживает три метода транспорта:
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. Транспорт Streamable HTTP (Рекомендуется для удалённых подключений)
uvx excel-mcp-server streamable-http
Подключение к транспорту Streamable HTTP:
{
"mcpServers": {
"excel": {
"url": "http://localhost:8000/mcp",
}
}
}
Переменные среды и обработка путей к файлам
Транспорты SSE и Streamable HTTP
При запуске сервера с протоколами SSE или Streamable HTTP вы обязаны установить переменную среды EXCEL_FILES_PATH на стороне сервера. Эта переменная сообщает серверу, где читать и записывать файлы Excel.
- Если не установлена, по умолчанию используется ./excel_files.
- При использовании этих транспортов значения filepath инструментов должны быть относительными к этой директории (например, reports/q1.xlsx); абсолютные пути и обход директорий отклоняются.
Вы также можете установить переменную среды FASTMCP_PORT, чтобы управлять портом, который слушает сервер (по умолчанию 8017, если не установлен).
- Пример (Windows PowerShell):
powershell
$env:EXCEL_FILES_PATH="E:\MyExcelFiles"
$env:FASTMCP_PORT="8007"
uvx excel-mcp-server streamable-http
- Пример (Linux/macOS):
bash
EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http
Транспорт Stdio
При использовании протокола stdio путь к файлу предоставляется при каждом вызове инструмента, поэтому вам не нужно устанавливать EXCEL_FILES_PATH на сервере. Сервер будет использовать путь, отправленный клиентом, для каждой операции.
Доступные инструменты
Сервер предоставляет полный набор инструментов для манипуляции с Excel. Полную документацию по всем доступным инструментам смотрите в TOOLS.md).
История звёзд
Лицензия
Лицензия MIT - подробности смотрите в LICENSE).