S
Swagger-MCP抓取器
@danishjsheikh/swagger-mcp
2 Stars
775 次浏览
danishjsheikh
更新于 2026-08-23
Swagger-MCP 是一种用于抓取 Swagger UI 的工具，它通过提取 swagger.json 文件并在运行时动态生成定义明确的 MCP 工具。这些工具可以被 MCP 客户端用于进一步的工具选择。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"swagger_loader": {
"args": [
"--specUrl=\u003cswagger/doc.json_url\u003e"
],
"command": "swagger-mcp"
}
}
}该服务需要配置环境变量：specUrl
服务介绍
swagger-mcp
概述
swagger-mcp 是一个工具，旨在通过提取 swagger.json 文件并动态生成定义良好的 mcp 工具来抓取 Swagger UI。这些工具可以被 MCP 客户端用于进一步的工具选择。
📽️ 演示视频
查看演示视频，展示项目的实际运行情况：
🙌 支持
如果您认为这个项目有价值，请在 LinkedIn 上支持我：
- 👍 点赞并分享我们的演示帖子
- 💬 在评论中留下您的想法和反馈
- 🔗 与我联系以获取未来的更新
您在 LinkedIn 上的支持将帮助我接触到更多的人，并改进项目！
前提条件
要使用 swagger-mcp，请确保您具备以下依赖项：
- LLM 模型 API 密钥 / 本地 LLM：需要访问 OpenAI、Claude 或 Ollama 模型。
- 任何 MCP 客户端：（使用 mark3labs - mcphost）
安装和设置
按照以下步骤安装和运行 swagger-mcp：
go install github.com/danishjsheikh/swagger-mcp@latest
swagger-mcp
MCP 配置
要与 mcphost 集成，请在 .mcp.json 中包含以下配置：
{
"mcpServers":
{
"swagger_loader": {
"command": "swagger-mcp",
"args": ["--specUrl=<swagger/doc.json_url>"]
}
}
}
演示流程
-
某些后端：
go install github.com/danishjsheikh/go-backend-demo@latest go-backend-demo -
Ollama
ollama run llama3.2 -
MCP 客户端
go install github.com/mark3labs/mcphost@latest mcphost -m ollama:llama3.2 --config <.mcp.json_file_path>
流程图
🛠️ 需要帮助
我正在努力改进工具定义以增强：
✅ 更好的错误处理 以获得更准确的响应
✅ LLM 行为控制 以确保它仅依赖于 API 响应 而不使用自己的内存
✅ 通过强制严格从 API 获取数据来防止幻觉和随机数据生成
如果您对改进这些方面有见解或建议，请通过以下方式贡献：
- 分享您的经验 与类似实现
- 提出修改建议 以改进工具定义
- 提供反馈 关于当前的限制
您的输入对于使此工具更加可靠和有效将是无价的！🚀
