项目简介
Cyberon 是一个 Flask Web 应用,它不仅提供了一个交互式的知识图谱可视化界面,还内嵌了一个 Model Context Protocol (MCP) 服务器。这个 MCP 服务器允许大型语言模型(LLM)客户端通过标准化的协议与 Cyberon 应用进行交互,获取上下文信息和执行工具,从而增强 LLM 应用的功能。
主要功能点
- 知识图谱可视化: 用户可以通过 Web 界面上传 Markdown 格式的本体文件,并以交互式知识图谱的形式进行浏览和探索。
- 实体与关系查询: 支持实体搜索、实体信息检索、概念路径查找等功能,帮助用户理解本体结构和内容。
- MCP 服务器: 内置 MCP 服务器,支持:
- 资源访问: 通过 URI 提供对本体资源的标准访问。
- 工具执行: 允许 LLM 客户端调用服务器端提供的本体分析工具。
- Prompt 模板: 支持 Prompt 模板,为 LLM 交互提供定制化的自然语言接口。
- 标准协议: 使用 Model Context Protocol (MCP) 标准协议,确保与兼容的 LLM 客户端进行有效通信。
- STDIO 传输: MCP 服务器默认使用 STDIO 传输协议,方便集成和部署。
安装步骤
- 克隆仓库
git clone https://github.com/CameronCarroll/CYBERON.git cd CYBERON
- 创建虚拟环境并安装依赖
python -m venv venv source venv/bin/activate # Linux/macOS # venv\Scripts\activate # Windows pip install -r requirements.txt
服务器配置
Cyberon MCP 服务器无需额外配置,它与 Flask Web 应用程序一同启动。
MCP 客户端配置示例 (JSON 格式):
{ "serverName": "Cyberon MCP Server", "command": "python", "args": ["mcp_server.py"] // 或者如果直接运行 Flask 应用 // "command": "python", // "args": ["run.py"] // 注意:如果使用 run.py 启动,MCP server 会作为 Flask 应用的一部分在后台运行 }
参数说明:
- 'serverName': MCP 服务器的名称,可自定义。
- 'command': 启动 MCP 服务器的命令,这里使用 'python'。
- 'args': 启动命令的参数,指定运行 'mcp_server.py' 脚本。如果客户端连接的是直接运行的 Flask 应用 (run.py),则使用 'run.py' 作为参数。
基本使用方法
-
启动 Cyberon 应用和 MCP 服务器:
在终端中,进入仓库目录并运行:
python run.py或者直接运行 MCP 服务器脚本:
python mcp_server.py -
访问 Web 界面:
打开浏览器,访问 'http://localhost:5001',即可体验知识图谱可视化功能。
-
连接 MCP 客户端:
配置 MCP 客户端,使用上述提供的配置信息连接到 Cyberon MCP 服务器。客户端即可通过 JSON-RPC 协议与服务器进行通信,利用服务器提供的资源、工具和 Prompt 模板。
重要提示:
- MCP 服务器默认通过 STDIO 传输协议工作,客户端需要配置相应的 STDIO 连接方式。
- 详细的 API 端点信息和使用方法请参考仓库中的 '/API_README.md' 文件。
信息
分类
AI与计算