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: 
INSERT DATA {
ex:subject1 ex:predicate1 "object1" .
ex:subject2 ex:predicate2 42 .
}

查询特定命名图

SELECT ?subject ?predicate ?object
FROM NAMED 
WHERE {
GRAPH  {
?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）。