Skip to content
Back to search

mcp_server

MCP-сервер для оффлайн установки. Инструменты подключаются отдельными модулями

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dmitfed--mcp-server/badge.svg)](/listings/dmitfed--mcp-server)

HTML

<a href="/listings/dmitfed--mcp-server"><img src="/api/listings/dmitfed--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 86 lines
  1. # Офлайн-сервер MCP
  2. Локальный Python-сервер инструментов для MCP-хостов. Сервер работает без
  3. интернета, принимает запросы по Streamable HTTP на `127.0.0.1` и подключает
  4. инструменты из явно указанных JSON-манифестов. Ядро проверяет аргументы
  5. и запускает обработчик в отдельном процессе с таймаутом.
  6. MCP-хост обращается к инструментам через этот сервер, а к модели через её
  7. локальный HTTP API. Сервер инструментов можно запустить и проверить при
  8. остановленной модели.
  9. ```text
  10. MCP-хост ── Streamable HTTP ── MCP-сервер ── обработчики инструментов
  11. └────── локальный HTTP API ── движок модели
  12. ```
  13. **Проверенная конфигурация** — Debian 13 amd64, CPython 3.13, MCP
  14. `2026-07-28`. Сквозная проверка с моделью пройдена на CPU с llama.cpp
  15. b12359 и `Qwen3-4B-Q4_K_M.gguf`.
  16. [Профиль и версии артефактов](specs/001-offline-mcp-core/research.md#первая-конфигурация-с-моделью)
  17. ## Быстрый запуск без модели
  18. На подключённой машине с Debian 13 amd64, CPython 3.13 и `python3-pip`
  19. выполните из корня репозитория. Введите идентификатор подготовленного
  20. базового образа Debian. Сборщик создаст новый каталог `offline-kit/` с
  21. wheelhouse, точными версиями и контрольными суммами.
  22. [Подготовка базового образа](specs/001-offline-mcp-core/deployment.md#1-подготовьте-debian-и-переносимый-комплект)
  23. ```bash
  24. read -r -p 'Идентификатор базового образа Debian: ' MCP_IMAGE_ID
  25. python3 scripts/build-offline-kit.py offline-kit --stage modules --image-id "$MCP_IMAGE_ID"
  26. ```
  27. Перенесите весь `offline-kit/` на целевую машину. В каталоге, где он лежит,
  28. выполните команды ниже. Если имя `mcp-core-runtime` уже занято, укажите
  29. свободный путь в `MCP_RUNTIME`. Проверочная команда `core` проверит пустой
  30. каталог и вызов `demo_echo`, затем сервер запустится в переднем плане.
  31. ```bash
  32. (
  33. set -eu
  34. MCP_KIT="$PWD/offline-kit"
  35. MCP_RUNTIME="$PWD/mcp-core-runtime"
  36. (cd "$MCP_KIT" && sha256sum --check SHA256SUMS)
  37. mkdir -- "$MCP_RUNTIME"
  38. python3 -m venv "$MCP_RUNTIME/venv"
  39. "$MCP_RUNTIME/venv/bin/python" -m pip --isolated install \
  40. --no-cache-dir --no-index --find-links "$MCP_KIT/wheelhouse" \
  41. --only-binary=:all: --require-hashes -r "$MCP_KIT/requirements.lock"
  42. "$MCP_RUNTIME/venv/bin/python" -m pip check
  43. "$MCP_RUNTIME/venv/bin/mcp-core-check" core \
  44. --empty-config "$MCP_KIT/examples/empty.toml" \
  45. --demo-config "$MCP_KIT/examples/demo.toml"
  46. "$MCP_RUNTIME/venv/bin/mcp-core" --config "$MCP_KIT/examples/demo.toml" --port 8765
  47. )
  48. ```
  49. Подключите локальный MCP-клиент по **Streamable HTTP** к
  50. `http://127.0.0.1:8765/mcp`. Конфигурация `demo.toml` публикует
  51. `demo_echo`. Для пустого каталога используйте `empty.toml`.
  52. [Полная инструкция с примером вызова](specs/001-offline-mcp-core/deployment.md)
  53. ## Инструменты
  54. Инструменты поставляются как самостоятельные Python-пакеты с собственными
  55. wheels, манифестами и тестами. Распаковка ZIP и чтение PDF реализованы
  56. в репозитории как два примера таких инструментов.
  57. | Инструмент | Назначение | Пакет и установка |
  58. |---|---|---|
  59. | `zip_extract` | Распаковывает локальный ZIP и возвращает список файлов | [`tools/zip/`](tools/zip) · [Руководство](specs/001-offline-mcp-core/add-zip-tool.md) |
  60. | `pdf_read` | Извлекает текст из выбранных страниц PDF через `pypdf` | [`tools/pdf/`](tools/pdf) · [Руководство](specs/001-offline-mcp-core/add-pdf-tool.md) |
  61. Установите выбранные пакеты в окружение `mcp-core` и добавьте пути к их
  62. манифестам в TOML.
  63. У каждого инструмента есть имя, описание, входная JSON Schema и ссылка
  64. на Python-функцию. Полномочия задаются в конфигурации экземпляра.
  65. [Контракт для нового модуля](specs/001-offline-mcp-core/contracts/module-v1.md)
  66. ## Документация и исходники
  67. - [Приёмка с llama.cpp и Qwen3](specs/001-offline-mcp-core/quickstart.md#проверить-модель-и-сквозной-диалог) и [контракт проверочного хоста](specs/001-offline-mcp-core/contracts/acceptance-host.md).
  68. - [Конфигурация сервера и HTTP-эндпоинт](specs/001-offline-mcp-core/contracts/server-mcp.md).
  69. - [Код ядра](src/mcp_offline_core), [конфигурации](examples), [тесты ядра](tests) и [сборщик офлайн-комплекта](scripts/build-offline-kit.py).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.