Mcpkg

🚀 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 許可證。