Apache Jena 的 MCP 服务器

一个允许 AI 代理通过 Apache Jena 进行 SPARQL 查询的 Model Context Protocol (MCP) 服务器。

概述

该项目实现了一个 MCP 服务器，使得 AI 代理（如 Cursor、Claude for Cline 或 Claude Desktop）能够访问和查询存储在 Apache Jena 中的 RDF 数据。该服务器提供了执行 SPARQL 查询和更新操作的工具。

特性

• 执行针对 Jena Fuseki 服务器的 SPARQL 查询
• 执行修改 RDF 数据的 SPARQL 更新
• 列出数据集中的可用命名图
• 支持 Jena Fuseki 的 HTTP Basic 认证
• 兼容 Model Context Protocol

先决条件

• Node.js（v16 或更高版本）
• 运行正常的 Apache Jena Fuseki 服务器，并加载了 RDF 数据
• 支持 Model Context Protocol 的 AI 代理（如 Cursor、Claude for Cline）

安装

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建 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 - 列出数据集中所有可用的命名图

环境变量

您也可以通过环境变量配置服务器：

• JENA_FUSEKI_URL：Jena Fuseki 服务器的 URL（默认值：http://localhost:3030）
• DEFAULT_DATASET：默认的数据集名称（默认值：ds）
• JENA_USERNAME：访问 Jena Fuseki 的 HTTP Basic 认证用户名
• JENA_PASSWORD：HTTP Basic 认证密码
• PORT：MCP 服务器的端口（对于 HTTP 传输，默认值：8080）
• API_KEY：MCP 服务器的身份验证 API 密钥

示例 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