transparent-openapi-mcp

KISS MCP-сервер, который сопоставляет спецификации OpenAPI v3 1:1 с инструментами MCP, — прозрачно: изменение загруженной спецификации OpenAPI никогда не требует изменения кода этого сервера.

Использование в качестве MCP-сервера Claude Code

Три шага: соберите образ, настройте конфигурацию на стороне сервера и подключите его к Claude Code.

1. Сборка

./podman_build.sh

2. Настройка сервера

Серверу нужна собственная конфигурация: локальный файл (монтируемый в контейнер), который указывает на список конфигураций, а тот, в свою очередь, — на ваши спецификации OpenAPI и бэкенды. Полное описание — что содержит каждый файл, как работает правило именования инструментов <prefix>_<operationId>, а также готовый к запуску набор примеров, проверенный в работе end-to-end, — приведено в examples/README.md.

3. Подключение к Claude Code

Claude Code должен знать, как запустить контейнер в качестве дочернего процесса stdio. Точная запись в конфигурации MCP, которую нужно добавить, и как она соотносится с конфигурацией на стороне сервера из шага 2, описана в examples/claude-code/README.md.

После этого выполните /mcp в сессии Claude Code и убедитесь, что transparent-openapi-mcp появляется со своими инструментами.

Related MCP server: ControlAPI-MCP

Попробуйте встроенный пример

Прежде чем подключать собственную реальную спецификацию и бэкенд, вы можете проверить, что вся цепочка работает, с помощью встроенного минимального примера:

./podman_build.sh

mkdir -p ~/t-o-m-config
cp examples/*.example.json ~/t-o-m-config/
cd ~/t-o-m-config
mv local-config.example.json local-config.json
mv config-list.example.json config-list.json
mv minimal-openapi.example.json minimal-openapi.json

# in another terminal, serve that directory:
cd ~/t-o-m-config && python3 -m http.server 8000

# back in the first terminal:
./podman_run.sh ~/t-o-m-config/local-config.json

Полное пошаговое описание, включая то, как вызвать инструмент и увидеть результат, приведено в examples/README.md: здесь сервер просто запускается — он молча работает через stdio, что является корректным поведением MCP.

Проектная документация

Полный набор требований (R-CTRL, R-DEPLOY, R-CFG, R-BOOT, R-TOOLS, R-FWD, R-STACK, R-RELEASE) и дизайн приведены в docs/core-mcp-server/requirements.md и docs/core-mcp-server/architecture.md.