RDF Explorer

🚀 RDF 探索者 v1.0.0

RDF 探索者是一個模型上下文協議（MCP）服務器，它提供了基於對話界面的知識圖譜（RDF 格式）探索和分析功能。支持本地文件模式和 SPARQL 終端模式，藉助自然語言處理技術，實現了 AI 與知識圖譜的交互，讓用戶能以問答形式便捷地從知識圖譜中獲取信息或執行復雜數據操作。

🚀 快速開始

# 克隆倉庫
git clone https://github.com/emekaokoye/mcp-rdf-explorer.git
cd mcp-rdf-explorer

# 初始化虛擬環境
python -m venv venv
source venv/bin/activate
# Windows: venv\Scripts\activate

# 安裝開發依賴
pip install -r requirements.txt

# 運行測試
pytest test_rdf_explorer.py -v

✨ 主要特性

• 本地文件模式：支持加載和解析本地的 Turtle 格式 RDF 文件。
• SPARQL 終端模式：支持連接遠程 SPARQL 服務進行數據查詢。
• 數據查詢：支持通過自然語言或直接查詢語法從知識圖譜中檢索數據。
• 數據分析：提供對知識圖譜結構、實體關係的分析功能。
• 上下文管理：維護對話上下文，支持多輪交互。
• 結果格式化：支持將查詢結果以多種格式（文本、表格、JSON 等）呈現。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/emekaokoye/mcp-rdf-explorer.git
cd mcp-rdf-explorer

# 初始化虛擬環境
python -m venv venv
source venv/bin/activate
# Windows: venv\Scripts\activate

# 安裝開發依賴
pip install -r requirements.txt

💻 使用示例

基礎用法

在本地文件模式或 SPARQL 終端模式下，你可以提出以下問題：

• 在本地文件模式下可以提問：
  • "顯示所有銷售部門的員工"
  • "找出前五名最年長的客戶"
  • "誰購買了超過三件產品"
  • "列出所有實體"
  • "使用 DBpedia 終端，列出邁克爾·傑克遜的 10 首歌曲"
  • "使用 Wikidata 終端，列出 5 座城市"
  • "統計三元組數量"
  • "分析知識圖譜結構"
  • "選擇 ..."
  • "搜索 '{文本}' "
  • "查找 '{URI}' 的關係"
  • "RDF 探索者運行在什麼模式？"
• 在 SPARQL 終端模式下可以提問：
  • "使用 DBpedia 終端，列出邁克爾·傑克遜的 10 首歌曲"
  • "使用 Wikidata 終端，列出 5 座城市"
  • "選擇 ..."
  • "搜索 '{文本}' "
  • "查找 '{URI}' 的關係"
  • "RDF 探索者運行在什麼模式？"

高級用法

示例配置

使用本地文件模式的配置示例：

{
  "mcpServers": {
    "rdf_explorer": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\server.py", "--triple-file", "your_file.ttl"]
    }
  }
}

使用 SPARQL 終端模式的配置示例：

{
  "mcpServers": {
    "rdf_explorer": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\server.py", "--sparql-endpoint", "https://example.com/sparql"]
    }
  }
}

📚 詳細文檔

工具

輸入輸出定義

• 輸入：
  • 自然語言問題或 SPARQL 查詢語句。
  • 可選參數包括：
    • --triple-file：本地 RDF 文件路徑。
    • --sparql-endpoint：遠程 SPARQL 終點 URL。
• 輸出：
  • 結果以用戶友好的格式呈現。
  • 支持 JSON 格式輸出，便於程序matic 處理。

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參見項目存儲庫中的 LICENSE 文件。