内容
# RCE CHO SPARQL MCP 服务器
MCP 服务器，用于 LLM 查询 RCE 文化遗产 SPARQL 端点。
构建于 CEO 本体（自动从 GitHub 加载）和 RCE 数据模型规则。
## 远程使用（无需安装）
服务器在 Render 上公开运行，可以直接使用：
```
https://mcp-server-rce-cho-http.onrender.com/mcp
```
### Claude Desktop（通过 mcp-remote 代理）
```json
{
"mcpServers": {
"rce-cho-sparql": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp-server-rce-cho-http.onrender.com/mcp"]
}
}
}
```
### Cursor
添加到 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"rce-cho-sparql": {
"url": "https://mcp-server-rce-cho-http.onrender.com/mcp"
}
}
}
```
### Open WebUI / 其他 MCP 客户端
直接使用 URL：`https://mcp-server-rce-cho-http.onrender.com/mcp`
> **注意：** 服务器运行在免费的 Render 层级，15 分钟不活动后可能会进入休眠状态。
> 在暂停后，第一次调用可能需要 20-30 秒。
---
## 本地安装
```bash
git clone https://github.com/rschalkrce/MCP-server-RCE-CHO-http.git
cd MCP-server-RCE-CHO-http
pip install -r requirements.txt
python server.py
```
### 连接到 Claude Desktop（本地）
**macOS：** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows：** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"rce-cho-sparql": {
"command": "python",
"args": ["/path/to/server.py"]
}
}
}
```
---
## 可用工具
| 工具 | 描述 |
|---|---|
| `get_ontology_context` | 返回完整的本体上下文（类、属性、路径、规则）。始终首先调用。 |
| `query_sparql` | 在端点上执行 SPARQL SELECT/ASK 查询 |
| `validate_query` | 在执行前检查查询的常见错误 |
| `describe_resource` | 描述特定 URI |
| `get_provincie_uri` | 返回荷兰省份的正确 URI |
## 工作原理
1. LLM 调用 `get_ontology_context()` → 获取所有类、属性和规则
2. LLM 根据本体构造 SPARQL 查询
3. LLM 调用 `validate_query(query)` → 阻止错误
4. LLM 调用 `query_sparql(query)` → 从源数据获取结果
5. LLM 以人类语言呈现结果
## 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
| `SPARQL_ENDPOINT` | RCE CHO 端点 | SPARQL 端点 URL |
| `MCP_TRANSPORT` | `stdio` | `stdio`, `http` 或 `sse` |
| `CEO_TTL_URL` | GitHub URL | CEO 本体 TTL URL |
## 技术细节
- **SPARQL 端点：** `https://api.linkeddata.cultureelerfgoed.nl/datasets/rce/cho/services/cho/sparql`
- **图：** `https://linkeddata.cultureelerfgoed.nl/graph/instanties-rce`
- **本体：** CEO v1.5，自动从 [GitHub](https://github.com/cultureelerfgoed/CEO) 加载
- **许可证：** CC0 1.0
## 来源
- [RCE 联结数据](https://linkeddata.cultureelerfgoed.nl)
- [CEO 本体](https://github.com/cultureelerfgoed/CEO)
- [SPARQL IDE](https://linkeddata.cultureelerfgoed.nl/rce/cho/sparql)
