local-delegate — MCP-сервер для Claude Code
MCP-сервер отдаёт механическую работу с текстом локальному LLM, совместимому с OpenAI API. Большие файлы читаются на стороне сервера и не занимают контекст Claude.
claude mcp add --env LOCAL_DELEGATE_BASE_URL=<LOCAL_DELEGATE_BASE_URL> --env LOCAL_DELEGATE_API_KEY=<LOCAL_DELEGATE_API_KEY> --transport stdio local-delegate -- uvx local-delegate-mcpЧто делает local-delegate
local-delegate — клиент любого OpenAI-совместимого эндпоинта: llama-swap, Ollama, LM Studio, vLLM. Задача формулируется как вызов MCP-инструмента, но вместо текста в аргументах передаётся path, и файл читается на стороне сервера. В контекст возвращается только короткий результат, поэтому документ не съедает окно и не обрабатывается Claude.
Работает в двух режимах: stdio и общий HTTP-демон. Демон поднимает MCP на http://127.0.0.1:9393/mcp и дашборд на http://127.0.0.1:9393/, где видно состояние бэкенда, расход RAM и VRAM, сохранённые токены контекста и историю делегаций. Если сессий или клиентов несколько, один демон избавляет от дублирующихся процессов.
Есть команда local-delegate install: она прописывает MCP-запись, хуки, скилл и правило делегирования в CLAUDE.md или AGENTS.md. Установка идемпотентна, перед правкой оставляет .bak, откатывается через local-delegate uninstall. Учтите два ограничения по таймаутам: Codex обрывает вызов MCP-инструмента через 60 с, а Claude — HTTP-запрос после 5 минут без ответа. Значение tool_timeout_sec в config.toml приходится возвращать после каждого install или update, потому что они перезаписывают этот блок.
Какие задачи решает
- сжать большой лог, не тратя контекст Claude
- разметить и классифицировать пачку текстов локальной моделью
- вытащить поля из документов по заданной схеме
- сгенерировать однотипный boilerplate без расхода квоты
- разделить одну локальную GPU между несколькими клиентами
Примеры запросов агенту
- Разбери файл
logs/build.logи выпиши только строки с ошибками - Извлеки из
invoices/номер, дату и сумму в таблицу - Разметь эти тексты по категориям через локальную модель
Как установить local-delegate
Командой платформы
claude mcp add --env LOCAL_DELEGATE_BASE_URL=<LOCAL_DELEGATE_BASE_URL> --env LOCAL_DELEGATE_API_KEY=<LOCAL_DELEGATE_API_KEY> --transport stdio local-delegate -- uvx local-delegate-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from local-delegate-mcp <команда>
Командой платформы
codex mcp add local-delegate --env LOCAL_DELEGATE_BASE_URL=<LOCAL_DELEGATE_BASE_URL> --env LOCAL_DELEGATE_API_KEY=<LOCAL_DELEGATE_API_KEY> -- uvx local-delegate-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from local-delegate-mcp <команда>
Файл настроек
{
"mcpServers": {
"local-delegate": {
"command": "uvx",
"args": [
"local-delegate-mcp"
],
"env": {
"LOCAL_DELEGATE_BASE_URL": "<LOCAL_DELEGATE_BASE_URL>",
"LOCAL_DELEGATE_API_KEY": "<LOCAL_DELEGATE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from local-delegate-mcp <команда>
Файл настроек
{
"servers": {
"local-delegate": {
"type": "stdio",
"command": "uvx",
"args": [
"local-delegate-mcp"
],
"env": {
"LOCAL_DELEGATE_BASE_URL": "<LOCAL_DELEGATE_BASE_URL>",
"LOCAL_DELEGATE_API_KEY": "<LOCAL_DELEGATE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from local-delegate-mcp <команда>
Командой платформы
gemini mcp add -e LOCAL_DELEGATE_BASE_URL=<LOCAL_DELEGATE_BASE_URL> -e LOCAL_DELEGATE_API_KEY=<LOCAL_DELEGATE_API_KEY> local-delegate uvx local-delegate-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from local-delegate-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о local-delegate
Как установить local-delegate в Claude Code?
Добавьте сервер командой claude mcp add local-delegate -e LOCAL_DELEGATE_API_KEY=<LOCAL_DELEGATE_API_KEY> -- uvx local-delegate-mcp. Если нужен свой адрес бэкенда, используйте вариант с --env LOCAL_DELEGATE_BASE_URL=<LOCAL_DELEGATE_BASE_URL> и --transport stdio.
Что делает local-delegate?
Отдаёт текстовые задачи локальному LLM через MCP-инструменты. Файл читается на стороне сервера, в контекст возвращается только результат.
Почему вызов обрывается на Codex или Claude?
Codex режет вызов MCP-инструмента через 60 с, а Claude закрывает HTTP-запрос после 5 минут без ответа. Поднять лимиты можно через tool_timeout_sec в config.toml и переменную CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT.
