transparent-openapi-mcp

一个 KISS MCP 服务器，将 OpenAPI v3 规范 1:1 透明地映射到 MCP 工具上——对已加载的 OpenAPI 规范的修改永远不需要改动本服务器自身的代码。

在 Claude Code 中将其用作 MCP 服务器

三步：构建镜像、配置好服务端配置、将其接入 Claude Code。

1. 构建

./podman_build.sh

2. 配置服务器

该服务器需要自己的配置：一个本地文件（挂载进容器），它指向一个配置列表，该配置列表又指向你的 OpenAPI 规范和后端。完整参考请参见 examples/README.md，其中包含每个文件的内容、<prefix>_<operationId> 工具命名规则，以及一套经过端到端验证的可运行示例。

3. 将其接入 Claude Code

Claude Code 需要知道如何将该容器作为 stdio 子进程启动。请参阅 examples/claude-code/README.md，了解需要添加的准确 MCP 配置条目，以及它如何与你第 2 步中的服务端配置相关联。

添加完成后，在 Claude Code 会话中运行 /mcp，确认 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 的正确行为）。

设计文档

参见 docs/core-mcp-server/requirements.md 和 docs/core-mcp-server/architecture.md，了解完整需求集（R-CTRL、R-DEPLOY、R-CFG、R-BOOT、R-TOOLS、R-FWD、R-STACK、R-RELEASE）及设计。