🚀 MCPKG - 模型上下文协议知识图谱

MCPKG 是一个采用 Go 语言实现的知识图谱系统，它借助模型上下文协议（MCP）对外提供服务。该系统提供了一种简单且强大的方式，用于存储、管理和查询以主语 - 谓词 - 宾语三元组形式呈现的语义信息。

🚀 快速开始

MCPKG 提供了便捷的方式来存储和查询语义信息。你可以通过 insert_triple 工具插入信息，使用 graph:// URI 格式查询信息。

✨ 主要特性

• 采用有向图实现，可用于存储结构化信息。
• 支持创建和查询语义三元组。
• 能够通过序列化实现持久化存储。
• 提供 MCP 服务器接口，方便程序进行访问。
• 支持使用自定义 URI 格式进行图查询。
• 采用读写互斥锁，确保线程安全。

📦 安装指南

依赖项

• Go 1.24+ 版本
• github.com/mark3labs/mcp - go
• gonum.org/v1/gonum
• github.com/stretchr/testify（用于测试）

💻 使用示例

基础用法

插入信息

使用 insert_triple 工具，通过指定主语、谓词和宾语参数来向图谱中添加信息。

// 假设这里是调用 insert_triple 工具的示例代码
// 实际代码可能需要根据具体工具实现来编写
// 这里仅为示意
insert_triple("主语", "谓词", "宾语")

查询信息

使用 graph:// URI 格式来查找实体之间的关系。

// 假设这里是使用 graph:// URI 格式查询的示例代码
// 实际代码可能需要根据具体实现来编写
// 这里仅为示意
query_result := query("graph://some_entity_relationship")

📚 详细文档

组件

知识图谱（KG）

核心数据结构，具备以下功能：

• 存储实体作为节点。
• 使用谓词表示关系（边）。
• 提供插入和查询三元组的方法。
• 支持序列化和反序列化操作。
• 通过读写互斥锁确保并发安全。

MCP 服务器

一个接口层，具备以下功能：

• 将知识图谱以 MCP 服务器的形式暴露出来。
• 提供工具进行三元组插入。
• 支持使用 URI 格式进行图查询。
• 实现无状态设计以提高可靠性。

📄 许可证

本项目采用 MIT 许可证。