MCP Jena

🚀 Apache Jena 的 MCP 服務器

本項目構建了一個 Model Context Protocol (MCP) 服務器，藉助 Apache Jena 讓 AI 代理能夠開展 SPARQL 查詢操作，為 AI 代理訪問和查詢存儲於 Apache Jena 中的 RDF 數據提供了便利。

🚀 快速開始

該項目實現了一個 MCP 服務器，讓 AI 代理（像 Cursor、Claude for Cline 或 Claude Desktop 這類）可以訪問並查詢存儲在 Apache Jena 裡的 RDF 數據。此服務器提供了執行 SPARQL 查詢和更新操作的工具。

✨ 主要特性

• 可執行針對 Jena Fuseki 服務器的 SPARQL 查詢。
• 能執行修改 RDF 數據的 SPARQL 更新。
• 可列出數據集中的可用命名圖。
• 支持 Jena Fuseki 的 HTTP Basic 認證。
• 與 Model Context Protocol 兼容。

📦 安裝指南

克隆倉庫

git clone https://github.com/ramuzes/mcp-jena.git
cd mcp-jena

安裝依賴項

npm install

構建 TypeScript 代碼

npm run build

💻 使用示例

基礎用法

以默認設置運行服務器（Jena 地址：localhost:3030，數據集名稱：ds）：

npm start

高級用法

指定自定義配置

指定自定義的 Jena 端點、數據集和認證憑據：

npm start -- --endpoint http://your-jena-server:3030 --dataset your_dataset --username your_username --password your_password

也可以使用短標誌：

npm start -- -e http://your-jena-server:3030 -d your_dataset -u your_username -p your_password

開發模式運行

在開發模式下，帶有自動轉錄功能運行：

npm run dev:transpile -- -e http://your-jena-server:3030 -d your_dataset -u your_username -p your_password

📚 詳細文檔

可用工具

此 MCP 服務器提供以下工具：

1. execute_sparql_query - 執行針對 Jena 數據集的 SPARQL 查詢。
2. execute_sparql_update - 執行修改數據集的 SPARQL 更新查詢。
3. list_graphs - 列出數據集中所有可用的命名圖。

環境變量

您也可以通過環境變量配置服務器：

示例 SPARQL 查詢

基本 SELECT 查詢

SELECT ?subject ?predicate ?object
WHERE {
  ?subject ?predicate ?object
}
LIMIT 10

插入數據的 UPDATE 查詢

PREFIX ex: <http://example.org/>
INSERT DATA {
  ex:subject1 ex:predicate1 "object1" .
  ex:subject2 ex:predicate2 42 .
}

查詢特定命名圖

SELECT ?subject ?predicate ?object
FROM NAMED <http://example.org/graph1>
WHERE {
  GRAPH <http://example.org/graph1> {
    ?subject ?predicate ?object
  }
}
LIMIT 10

資源

• Model Context Protocol (MCP)
• Apache Jena
• Node.js

先決條件

• Node.js（v16 或更高版本）。
• 運行正常的 Apache Jena Fuseki 服務器，並加載了 RDF 數據。
• 支持 Model Context Protocol 的 AI 代理（如 Cursor、Claude for Cline）。