OmnySys MCP 服务器
使用说明(Markdown 要点)
-
项目简介
- OmnySys 是一个以 MCP(Model Context Protocol)为核心的后端服务器,聚焦对代码库进行静态分析、暴露分析结果的工具集和可扩展的提示模板,供 LLM 客户端在生成、修改代码前后获取上下文信息与能力。
-
主要功能点
- 资源管理与访问:托管分析结果、代码档案等资源,提供数据访问能力。
- 工具注册与执行:注册多种 MCP Tools,LLM 可以调用外部功能(如影响分析、代码检测、测试生成等)。
- Prompt 模板定义与渲染:支持按需渲染与组合的 Prompt 模板,用于对话与推理过程中的上下文注入。
- JSON-RPC 通信:与客户端通过标准的 JSON-RPC 进行请求/响应,支持会话管理与能力声明。
- 多传输协议支持:WS、SSE、Stdio 等传输方式,便于在不同场景下接入。
- 100% 静态分析能力融合:借助 Tree-sitter、SQLite、图形分析等实现对代码的静态分析与数据可观测性,减少对 LLM 的依赖。
-
安装步骤
- 克隆仓库并进入项目目录
- 安装依赖并构建
- 启动 MCP HTTP 服务器
- 通过 IDE 或客户端配置 MCP 服务端连接
-
服务器配置(给 MCP 客户端的配置信息示例说明)
- 为了让 MCP 客户端与 OmnySys 服务器建立连接,需要配置一个 MCP 客户端配置文件(JSON),其中应包含:
- server 名称 device 名称(如 omnysys)
- 启动命令及参数(command 与 args),用于在需要时启动或连接到 MCP 服务器
- 端口与地址通常采用默认端口 9999,URL 路径为 /mcp(示例仅作字段说明,具体请参考实际部署)
说明性文本(非代码块,直接以 JSON 结构说明字段)
- serverName: omnysys
- command: node
- args: ["src/layer-c-memory/mcp-http-server.js"]
- url: "http://127.0.0.1:9999/mcp"
- 为了让 MCP 客户端与 OmnySys 服务器建立连接,需要配置一个 MCP 客户端配置文件(JSON),其中应包含:
-
基本使用方法
- 启动服务器后,使用目标 MCP 客户端加载 OmnySys 的 MCP 服务配置
- 通过客户端发起资源读取、工具调用、Prompts 获取等 MCP 请求
- LLM 在调用工具前可以先查询 资源/工具/提示模板,以获得完整的上下文与能力