项目简介

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 传输协议,方便集成和部署。

安装步骤

  1. 克隆仓库
git clone https://github.com/CameronCarroll/CYBERON.git
cd CYBERON
  1. 创建虚拟环境并安装依赖
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' 作为参数。

基本使用方法

  1. 启动 Cyberon 应用和 MCP 服务器:

    在终端中,进入仓库目录并运行:

    python run.py

    或者直接运行 MCP 服务器脚本:

    python mcp_server.py
  2. 访问 Web 界面:

    打开浏览器,访问 'http://localhost:5001',即可体验知识图谱可视化功能。

  3. 连接 MCP 客户端:

    配置 MCP 客户端,使用上述提供的配置信息连接到 Cyberon MCP 服务器。客户端即可通过 JSON-RPC 协议与服务器进行通信,利用服务器提供的资源、工具和 Prompt 模板。

重要提示:

  • MCP 服务器默认通过 STDIO 传输协议工作,客户端需要配置相应的 STDIO 连接方式。
  • 详细的 API 端点信息和使用方法请参考仓库中的 '/API_README.md' 文件。

信息

分类

AI与计算