Oxigraph MCP Server

Oxigraph MCP 服务

一个适用于 Oxigraph 的模型上下文协议（MCP）服务。Oxigraph 是一个快速、轻量并支持 SPARQL 的 RDF 三元组存储。

Oxigraph 是一个用 Rust 编写的高性能内存或基于文件的 RDF 图数据库。此 MCP 服务提供了一个便于 Claude 使用的封装，让用户能够通过模型上下文协议访问 PyOxigraph（Oxigraph 的 Python 绑定）。

快速入门

安装

uv pip install mcp-server-oxigraph

Claude Desktop 最小配置

将以下内容添加到 Claude Desktop MCP 配置中：

"oxigraph": {
  "command": "uv",
  "args": ["run", "mcp-server-oxigraph"],
  "env": {}
}

设置默认数据库（可选）

若要设置特定的默认数据库位置，请添加 OXIGRAPH_DEFAULT_STORE 环境变量：

"oxigraph": {
  "command": "uv",
  "args": ["run", "mcp-server-oxigraph"],
  "env": {
    "OXIGRAPH_DEFAULT_STORE": "~/.claude/my_knowledge_graph.oxigraph"
  }
}

为什么使用 Oxigraph MCP？

Oxigraph MCP 适用于：

• 快速构建知识库：在可查询的图数据库中存储结构化信息
• 原型化语义应用：以交互方式测试数据模型和查询
• 模式开发：设计和测试 RDF 模式与本体
• 本地数据存储：在不依赖外部服务的情况下维护持久化数据
• SPARQL 探索：在交互式环境中试验复杂的 SPARQL 查询

功能

此 MCP 服务提供：

• 直接访问 PyOxigraph：简洁、无状态的 PyOxigraph 功能封装
• 多存储管理：创建、打开和管理多个基于文件的存储
• 全面支持 RDF：使用所有核心 RDF 数据类型和操作
• 完整的 SPARQL 实现：执行查询和更新，并返回结构规范的结果
• 丰富的序列化选项：支持所有主要 RDF 格式

关于 Oxigraph

Oxigraph 是一个用 Rust 实现的开源 RDF 三元组存储。其主要功能包括：

• 使用 RocksDB 进行快速的内存或基于文件的存储
• 完整支持 SPARQL 1.1 查询和更新
• 符合 W3C 标准
• 支持多种 RDF 序列化格式
• 与其他图数据库相比，占用的内存极低

此 MCP 服务使用 PyOxigraph，即 Oxigraph 的官方 Python 绑定。

支持的 RDF 格式

Oxigraph MCP 服务支持以下 RDF 序列化格式：

格式	文件扩展名	MIME 类型	支持命名图
Turtle	.ttl	text/turtle	否
N-Triples	.nt	application/n-triples	否
N-Quads	.nq	application/n-quads	是
TriG	.trig	application/trig	是
RDF/XML	.rdf	application/rdf+xml	否
N3	.n3	text/n3	否

你可以使用 oxigraph_get_supported_formats() 函数以编程方式获取此信息。

默认存储配置

服务管理两种类型的默认存储：

1. 系统默认存储：位于 ~/.mcp-server-oxigraph/default.oxigraph
2. 用户默认存储：通过设置 OXIGRAPH_DEFAULT_STORE 环境变量指定

启动时，服务会初始化两个存储（如果已配置）：

• 始终创建系统默认存储
• 如果指定了用户默认存储，也会对其进行初始化
• 如果指定了用户默认存储，操作将使用该存储；否则使用系统默认存储

你无需显式创建或打开这些存储——服务启动时会自动初始化。所有未指定存储路径的操作都会使用相应的默认存储。

基本用法示例

配置完成后，你可以在 Claude 中使用 Oxigraph MCP 工具处理 RDF 数据：

1. 向默认存储添加 RDF 三元组

   oxigraph_create_named_node(iri: "http://example.org/subject")
   oxigraph_create_named_node(iri: "http://example.org/predicate")
   oxigraph_create_literal(value: "Object value")
   oxigraph_create_quad(subject: subject, predicate: predicate, object: object)
   oxigraph_add(quad: quad)
   

2. 使用 SPARQL 查询

   oxigraph_query(query: "SELECT * WHERE { ?s ?p ?o } LIMIT 10")
   

3. 以不同格式导入和导出 RDF 数据

   oxigraph_parse(data: "@prefix ex: <http://example.org/> . ex:a ex:b ex:c .", format: "turtle")
   oxigraph_serialize(format: "ntriples")
   oxigraph_get_supported_formats()
   

4. 根据需要创建自定义存储

   oxigraph_create_store(store_path: "/path/to/my/custom.oxigraph")
   oxigraph_query(query: "SELECT * WHERE { ?s ?p ?o }", store_path: "/path/to/my/custom.oxigraph")
   

API 文档

存储管理函数

• oxigraph_create_store：创建新存储（内存或基于文件）
• oxigraph_open_store：打开现有的基于文件的存储
• oxigraph_close_store：关闭存储并将其从管理器中移除
• oxigraph_backup_store：创建存储的备份
• oxigraph_restore_store：从备份还原存储
• oxigraph_optimize_store：优化存储以提升性能
• oxigraph_list_stores：列出所有受管理的存储

注意：大多数操作都可以使用默认存储，无需指定 store_path。对于持久化存储，建议将文件路径用作 store_path，以便清晰明了。

RDF 数据模型函数

• oxigraph_create_named_node：创建用于 RDF 语句的 NamedNode
• oxigraph_create_blank_node：创建用于 RDF 语句的 BlankNode
• oxigraph_create_literal：创建用于 RDF 语句的 Literal
• oxigraph_create_quad：创建 Quad（带可选图的三元组）
• oxigraph_add：向存储中添加一个 quad
• oxigraph_add_many：向存储中添加多个 quad
• oxigraph_remove：从存储中移除一个 quad
• oxigraph_remove_many：从存储中移除多个 quad
• oxigraph_clear：移除所有 quad
• oxigraph_quads_for_pattern：查询与模式匹配的 quad

SPARQL 函数

• oxigraph_query：对存储执行 SPARQL 查询
• oxigraph_update：对存储执行 SPARQL 更新
• oxigraph_query_with_options：使用自定义选项执行 SPARQL 查询
• oxigraph_run_query：对存储运行 SPARQL 查询或更新

序列化函数

• oxigraph_parse：解析 RDF 数据并将其添加到存储中
• oxigraph_serialize：将存储序列化为字符串
• oxigraph_import_file：从文件导入 RDF 数据
• oxigraph_export_graph：将图导出到文件
• oxigraph_get_supported_formats：获取受支持的 RDF 格式列表

许可证

MIT 许可证