shuck-file — MCP-сервер для Claude Code: документы в Markdown
Превращает Word, PDF, Excel, PowerPoint и CSV в чистый Markdown. Большие файлы отдаёт картой разделов, чтобы агент читал только нужное.
claude mcp add shuck-file -- uvx shuck-fileЧто делает shuck-file
shuck-file ставится как MCP-сервер и даёт агенту два инструмента: shuck для конвертации и list_formats со списком поддерживаемых форматов. Внутри — отдельные экстракторы под каждый тип файла: python-docx для .docx, pdfplumber для .pdf, openpyxl для .xlsx, python-pptx для .pptx, стандартная библиотека для .csv. Из Word сохраняются заголовки, жирный и курсив, списки и таблицы; из PDF — текст и разрывы страниц; из Excel — все листы таблицами.
Логика такая: мелкий файл выводится целиком, крупный возвращает карту документа с разделами, оценкой токенов и подсказками, что делать дальше. Дальше можно взять только нужные разделы через --sections s1,s3, поискать по тексту через --grep, вытянуть одни таблицы или уложиться в бюджет токенов через --budget 4000. Есть probe для принудительной карты и pull как синоним --all.
Ставится пакет через pip install shuck-file — он же приносит CLI shuck и сам сервер. Для запуска нужен uvx, потому что команды подключения вызывают uvx shuck-file. Если uvx не установлен, MCP-сервер не поднимется, и агент просто не увидит инструментов.
Какие задачи решает
- прочитать большой PDF, не забивая контекст целиком
- вытащить таблицы из Excel в виде Markdown
- найти нужный фрагмент в отчёте по ключевому слову
- собрать конспект презентации вместе с заметками докладчика
- уложить содержимое документа в заданный лимит токенов
Примеры запросов агенту
- Сконвертируй
quarterly-report.pdfв Markdown и покажи карту разделов - Достань из
data.xlsxтолько заголовки колонок и первые 5 строк - Найди в
report.pdfвсе упоминания выручки через--grep
Как установить shuck-file
Командой платформы
claude mcp add shuck-file -- uvx shuck-fileuvx запускает команду с именем пакета; если в README она другая — uvx --from shuck-file <команда>
Командой платформы
codex mcp add shuck-file -- uvx shuck-fileuvx запускает команду с именем пакета; если в README она другая — uvx --from shuck-file <команда>
Файл настроек
{
"mcpServers": {
"shuck-file": {
"command": "uvx",
"args": [
"shuck-file"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from shuck-file <команда>
Файл настроек
{
"servers": {
"shuck-file": {
"type": "stdio",
"command": "uvx",
"args": [
"shuck-file"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from shuck-file <команда>
Командой платформы
gemini mcp add shuck-file uvx shuck-fileuvx запускает команду с именем пакета; если в README она другая — uvx --from shuck-file <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о shuck-file
Как установить shuck-file в Claude Code?
Одной командой: claude mcp add shuck-file -- uvx shuck-file. Она регистрирует MCP-сервер, после чего агент получает инструменты shuck и list_formats.
Что делает shuck-file?
Конвертирует документы в Markdown для агентов. Мелкие файлы отдаёт целиком, крупные — картой разделов с оценкой токенов, чтобы читать только нужные куски.
Какие форматы поддерживает shuck-file?
Word (.docx), PDF, Excel (.xlsx), PowerPoint (.pptx) и CSV. Список можно получить командой shuck --formats или инструментом list_formats.
