桃子桃子快讯
返回首页
工具

OpsCat 开源:轻量软件目录工具,原生集成 MCP

单二进制软件目录平台,自动发现微服务并通过 MCP 为 AI 编程代理提供架构上下文。

2026.07.28 · 周二3 分钟阅读

OpsCat 是一款面向平台工程场景的轻量化软件目录工具,以单一二进制形式提供自动服务发现、依赖图可视化、合规评分与原生 MCP(Model Context Protocol)服务。该项目以 Show HN 形式发布在 Hacker News,目标是以低于 30MB 的内存占用替代传统重型开发者门户(如 Backstage)。

核心定位与特性

OpsCat 由 Go 语言编写,内嵌基于 React/Vite 的 Web UI,无需任何外部运行时依赖。它可在零配置下扫描代码仓库,自动识别技术栈(Go、Node、Python、Rust、Java)、容器(Dockerfile)、基础设施(K8s、Helm、Terraform)以及 API 规范(OpenAPI、GraphQL、Proto)。

主要能力包括:

  • 自动发现:在指定目录下推断微服务、容器与基础设施实体
  • 2D 依赖图:实时展示服务、系统与资源之间的关系
  • 合规评分卡:基于文档、归属、容器化与 API 规范自动计算 0–100% 健康分
  • 多格式导出:支持 JSON、YAML 与 ASCII 表格

MCP 与 AI 代理集成

OpsCat 实现了 MCP 规范,同时支持 stdio 与 HTTP SSE 两种传输方式,能够让 Claude、Cursor、Antigravity、Devin 等 AI 编程代理直接查询服务架构、所有者与健康指标。

当前向 AI 代理暴露的工具包括:

  • catalog_list_services:按所有者、技术栈或最低评分过滤服务
  • catalog_get_service:获取详细元数据、评分卡与基础设施规格
  • catalog_scan_workspace:动态触发工作区扫描
  • catalog_get_dependencies:查询上下游服务依赖关系

在 Cursor 或 Claude Desktop 中,只需将 OpsCat 注册为 MCP 服务即可调用上述工具。

快速上手

  • 构建:git clone https://github.com/opscat/opscat.git && cd opscat && go build -o bin/opscat ./cmd/opscat
  • 扫描:./bin/opscat scan .,结果保存到 SQLite
  • 启动 Web 与 MCP:./bin/opscat serve --http :8080,浏览器访问 http://localhost:8080
  • 仅 MCP 模式:./bin/opscat serve --stdio,供 IDE 集成

架构与许可

项目核心由自动发现模块、内嵌 Web UI、统一的内存图 + SQLite 存储以及 MCP JSON-RPC 服务组成。仓库根目录可选择性放置 catalog.yaml 来覆盖或补充服务元数据。OpsCat 以 Apache 2.0 协议开源,单元测试可通过 go test ./... -v 运行。作为一个独立的轻量工具,它主要面向希望快速搭建内部服务目录并向 AI 代理开放上下文的小型团队。

信源