transparent-openapi-mcp

Un servidor MCP KISS que mapea las especificaciones OpenAPI v3 1:1 a herramientas MCP, de forma transparente: un cambio en una especificación OpenAPI cargada nunca requiere un cambio en el propio código de este servidor.

Uso de este como servidor MCP de Claude Code

Tres pasos: construir la imagen, preparar la configuración del servidor e integrarlo en Claude Code.

1. Construir

./podman_build.sh

2. Configurar el servidor

El servidor necesita su propia configuración: un archivo local (montado en el contenedor) que apunta a una lista de configuración, la cual a su vez apunta a tus especificaciones OpenAPI y backends. Consulta examples/README.md para la referencia completa: qué contiene cada archivo, la regla de nomenclatura de herramientas <prefix>_<operationId> y un conjunto de ejemplos ejecutables que funciona de extremo a extremo.

3. Integrarlo en Claude Code

Claude Code necesita saber cómo iniciar el contenedor como subproceso de stdio. Consulta examples/claude-code/README.md para la entrada de configuración MCP exacta que hay que añadir y cómo se relaciona con tu configuración del servidor del paso 2.

Una vez añadida, ejecuta /mcp en una sesión de Claude Code y confirma que transparent-openapi-mcp aparece con sus herramientas.

Related MCP server: ControlAPI-MCP

Pruébalo con el ejemplo incluido

Antes de conectar tu propia especificación/backend reales, puedes verificar que toda la cadena funciona usando el ejemplo mínimo incluido:

./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

Consulta examples/README.md para ver la guía completa, incluido cómo invocar una herramienta y ver un resultado (esto solo inicia el servidor: permanece en silencio en stdio, que es el comportamiento correcto de MCP).

Documentación de diseño

Consulta docs/core-mcp-server/requirements.md y docs/core-mcp-server/architecture.md para el conjunto completo de requisitos (R-CTRL, R-DEPLOY, R-CFG, R-BOOT, R-TOOLS, R-FWD, R-STACK, R-RELEASE) y el diseño.