GraphDB Desktop

MCP数据服务

提供方 Swissbit92

数据服务 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

GraphRAG MCP是一个本地优先的模块化系统,将加密白皮书转换为知识图谱和可向量搜索的语料库,通过RAG和知识图谱增强回答相关问题。

一句话选型结论

按资料字段整理

GraphDB Desktop 属于数据服务类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

知识图谱Python本地部署加密技术本地AI问答系统向量检索

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
GraphDB Desktop当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Swissbit92上游标注的维护方 Swissbit92
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

16.5 KB
来自项目仓库与上游目录的原文,未做删改

🧠 GraphRAG MCP(大脑图谱检索增强生成多模态处理/模型/系统)

> 以实体为中心的检索增强生成技术在加密货币白皮书中的应用\
> 本地优先 • 私有 • 准备就绪,适用于FastMCP


1️⃣ ✨ 概述

为什么选择这个项目?

  • ⚡(闪电符号,无特定含义,可单独使用或根据上下文表示速度、能量、惊喜等) 快速且专注: 实体过滤检索将上下文范围缩小到正确的标记/协议。

🔁 典型用法

  1. 解析并标注白皮书 → 构建嵌入表示并插入实体。
  2. 通过(某种方式)提问 rag.qa (语义+实体过滤检索),可选地使用知识图谱(KG)标签/别名进行丰富。
  3. 获取简洁的大型语言模型(LLM)答案,并附上来源片段的内联引用。

2️⃣ 特点/功能

🧩 知识图谱(KG)

  • 仅实体架构 使用RDF/OWL本体(mcp-core.ttl, mcp-crypto.ttl)。
  • 建立在……之上 Ontotext GraphDB 11+(版本) 带有SHACL验证和SPARQL/GraphQL端点。
  • 存储规范实体,如代币、协议、组件和组织。
  • 通过别名、标签和关系,实现对RAG答案的知识图谱(KG)丰富化。

🔍 向量检索(RAG)

  • 使用(某种方法或工具)生成的嵌入 Ollama 的 nomic-embed-text 模型。
  • 支持 语义的 和 实体过滤过的 用于精确上下文检索的检索模式。
  • 每个数据块都包含结构化的元数据: doc_id, chunk_id, entity_ids, section_type,以及 page。

🧠 本地大型语言模型推理

  • 兼容如……等型号 llama3.1:latest, qwen2.5:14b-instruct,或 mistral。
  • 执行标注、总结以及最终的质量保证(QA)综合工作。
  • 包括确定性(的内容/方法/等) 模拟模式 用于离线测试和持续集成(CI)。

⚙️ FastMCP 服务器

  • 两台模块化服务器通过(某种方式)暴露工具 FastMCP 2.x:
  • rag → rag.search, rag.embed_and_index, rag.reindex, rag.delete, rag.health, rag.qa
  • kg → sparql_query, sparql_update, push_labels, validate_labels, list_documents, kg.health
  • 两者均可通过标准I/O在本地运行,并且与MCP协调器兼容。

🔒 隐私与可移植性

  • 100%离线操作——适用于断网或研究环境。
  • 可复现的本地堆栈(GraphDB + Chroma + Ollama + FastMCP)。
  • 在Windows 11、macOS或Linux系统上均可无缝运行。

🚀 准备就绪,可集成

  • 即插即用,与 MCP协调员 或者 Streamlit 应用程序 供最终用户问答使用。
  • 可与其他MCP(管理控制点/主控程序等,具体含义根据上下文确定)实现互操作,例如:
  • Brave API MCP(网页搜索)
  • MongoDB MCP(策略数据)
  • Telegram MCP(消息传递)
  • Gmail MCP(电子邮件检索)
  • 返回干净的JSON输出,便于在代理工作流中进行链式调用。

3️⃣ 🏗️ 建筑

这个(或:那个) GraphRAG MCP 建筑融合 知识图谱推理, 基于向量的检索,和 本地大型语言模型(LLM)合成 — 全都在 MCP 互操作性标准。\
它专为……而设计 清晰度, 隐私,和 模块化可扩展性。


🧭 高级概述

层 技术 目的 示例组件
🗂 摄入层(或摄入层,根据上下文,“Ingestion Layer”可理解为系统或数据处理中的一个层级,负责接收或处理输入数据) Python + LangChain 读取PDF,将其分割成语义块,并使用大型语言模型(LLM)进行标注 pdf_reader.py, semantic_splitter.py, llm_chunk_tagger.py
🧩 知识图谱层(KG) GraphDB(Ontotext)+ RDFLib 存储规范实体(令牌、协议、组织) graphdb_sink.py, namespaces.pySHACL shapes(SHACL形状)
磁盘 向量检索层(RAG) ChromaDB + Ollama 嵌入 存储文本块 + 元数据 + 用于语义检索的嵌入 chroma_store.py, .chroma/
⚙️ MCP层 FastMCP 2.x 暴露标准化的MCP工具(rag.*, kg.*) rag_server.py, kg_server.py
🧠 大语言模型(LLM)合成层 Ollama 大语言模型(LLMs)llama3.1, qwen2.5 利用检索到的上下文和知识图谱(KG)信息回答问题 rag.qa, llm_chunk_tagger
💬 用户界面层 MCP协调员 / Streamlit 连接多个MCP以进行对话式问答 协调员用户界面或自定义Streamlit仪表板

🔹 数据流图```text

┌────────────────────────────────────────┐
│ Whitepapers │
│ (PDFs, research papers, documentation) │
└───────────────────┬────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ 📄 Ingestion & Labeling │
│ pdf_reader → semantic_splitter → │
│ llm_chunk_tagger → postprocess │
└───────────────────┬─────────────────────────┘
│
┌────────┴────────┐
│ │
▼ ▼
┌────────────────┐ ┌──────────────────────┐
│ 🧠 GraphDB KG │ │ 💾 Chroma RAG │
│ Entities & IRIs │ │ Chunks + Embeddings │
└────────┬────────┘ └────────┬────────────┘
│ │
▼ ▼
┌───────────────┐ ┌───────────────┐
│ ⚙️ kg_server │ │ ⚙️ rag_server │
│ (FastMCP) │ │ (FastMCP) │
└────────┬──────┘ └──────┬────────┘
│ │
└────────┬───────────┘
▼
┌────────────────────────────────┐
│ 💬 MCP Coordinator / Streamlit │
│ User-facing Q&A Interface │
└────────────────────────────────┘


______________________________________________________________________

### 🧠 它的工作原理(分步说明)

| 步骤 | 描述 | 输入 | 输出 |
|:----:|:-------------|:------|:--------|
| **1️⃣** | **PDF解析** | 白皮书PDF | 原始文本页面 |
| **2️⃣** | **语义分割** | 原始文本 | 有意义的片段(按部分/主题划分) |
| **3️⃣** | **大语言模型标注** | 文本块 | 实体、关系和章节标签 |
| **4️⃣** | **后处理** | 标记的片段 | 已清理的带有规范实体IRI的JSONL文件 |
| **5️⃣** | **索引编制** | JSONL 标签 | Chroma 嵌入 + 知识图谱三元组 |
| **6️⃣** | **检索(rag.search)** | 查询文本/实体 | 相关片段 |
| **7️⃣** | **补充(可选)** | 提取的实体 | 知识图谱中的别名、定义 |
| **8️⃣** | **答案综合(rag.qa)** | 问题+上下文 | 简洁答案及引用 |

______________________________________________________________________

### 🌐 数据模态

| 数据类型 | 存储 | 示例 |
|:-----------|:--------|:--------|
| 🧱(石头) **实体** | GraphDB | `` → `rdf:type crypto:Token` |
| 📜 **块(或称为“数据块”)** | Chroma | “比特币是一种点对点的电子现金系统……” |
| 🧩(拼图块) **嵌入** | Chroma / Ollama | 768维 `nomic-embed-text` 向量 |
| 🧮(计算器图标,无实际文字含义) **出处;来源** | 元数据 | `doc_id`, `chunk_id`, `page`, `entity_ids[]` |
💬 **答案** | MCP JSON | `{ "answer": "...", "citations": [...] }` |

______________________________________________________________________

### 🧱 核心MCP工具

| 服务器 | 工具 | 描述 |
|:--------|:------|:-------------|
| | `rag.embed_and_index` | 将新标记的片段添加到索引中 |
| | `rag.reindex` | 从输出目录重建 |
| | `rag.delete` | 按ID或过滤器删除 |
| | `rag.qa` | 使用大型语言模型(LLM)进行综合问答 |
| | `rag.health` | 诊断与商店信息 |
🧠 **KG(千克)** | `sparql_query` / `sparql_update` | 在GraphDB上执行SPARQL查询 |
| | `push_labels` / `validate_labels` | 添加或验证知识图谱条目 |
| | `list_documents`, `get_chunk` | 提取文档元数据 |
| | `kg.health` | 检查GraphDB仓库状态 |

______________________________________________________________________

## 4️⃣ ⚙️ 安装与设置

设置您的本地(环境/配置) **GraphRAG MCP环境** 只需几步!\
这个堆栈完全离线运行,并且与(其他系统/组件)无缝集成 **Ollama(注:这是一个专有名词或特定项目名,直接音译为中文可能无实际意义,但在此提供音译以保持原文形式)**, **GraphDB(中文可译为“图形数据库”)**,和 **色度**。

______________________________________________________________________

### 🧾 先决条件

| 要求 | 描述 | 示例 |
|:-------------|:-------------|:----------|
| 🐍(一条蛇) **python** | 版本 **三月十一号加** 推荐 | `python --version` → `Python 3.11.8` |
| 🧩(拼图块) **GraphDB Desktop 11+(或译为:GraphDB 桌面版 11及以上版本)** | 本地知识图谱数据库 | 运行于 `http://localhost:7200` |
| 工具 **FastMCP** | 多组件平台运行时(2.x)| 通过安装 `pip` |

______________________________________________________________________

### 🧱 文件夹布局(简化版)

| 文件夹 | 用途 | 示例内容 |
|:--------|:----------|:----------------|
| `src/` | 核心代码库 | `pipeline.py`, `mcp/`, `kg/`, `rag/` |
| `outputs/run_simple/` | 生成的输出 | 标记的片段、报告、嵌入表示 |
| `.chroma/` | 染色体持久向量存储 | `chroma.sqlite3`, `index/` |
| `.env` | 环境配置 | Ollama、GraphDB、Chroma 设置 |
| `tests/` | 离线单元测试 | `test_rag_qa.py`, `test_kg_server.py` |

______________________________________________________________________

### 分步设置指南

#### 🪄 1️⃣ 克隆并创建虚拟环境```bash
git clone https://github.com/Swissbit92/GraphDB_Desktop.git

⚡ 2️⃣ 激活环境

📦 3️⃣ 安装依赖项```bash

pip install -r requirements.txt


#### ⚙️ 4️⃣ 验证安装```bash
python -m src.mcp.rag_server --list-tools
python -m src.mcp.kg_server --list-tools

✅ 您应该能看到像这样的工具 rag.qa, rag.search,以及 kg.health.


🧠 可选:预加载 Ollama 模型

模型 用途 拉取命令
驴子 llama3.1:latest(可译为“最新版本的llama3.1”) 默认推理+总结模型 ollama pull llama3.1:latest

🔍 快速理智检查

运行快速健康诊断以确保所有配置均正确无误:```bash
pytest -q
python -m src.mcp.rag_server --run-tool rag.health
python -m src.mcp.kg_server --run-tool kg.health


如果两者都返回✅ **好的**,你已经准备好运行这个数据处理流程并开始查询你的(数据/信息)了 **知识图谱 + 检索增强生成(RAG)** 系统!

______________________________________________________________________

## 5️⃣ 🧪 如何使用与测试

### 📥 吸收白皮书内容并构建指数```bash
# Place your PDFs under .\whitepapers\ then run:
python -m src.pipeline --input ".\whitepapers\*.pdf"

✅ 输出:

  • 带标签的JSONL(每行一个JSON对象的格式) outputs\run_simple\labels\
  • 色度指数 .chroma\
  • (如果启用)将实体推送到GraphDB存储库 mcp_kg

🖧 启动MCP服务器(RAG + KG)```bash

Terminal A

python -m src.mcp.rag_server
``````bash

Terminal B

python -m src.mcp.kg_server


💡 提示:在另一个 PowerShell 窗口中,确认工具是否可用:```bash
python -m src.mcp.rag_server --list-tools
python -m src.mcp.kg_server --list-tools

🔎 快速检索检查(RAG)```bash

Example: semantic search for "peer-to-peer electronic cash"

python -m src.mcp.rag_server --run-tool rag.search --input '{ "text": "peer-to-peer electronic cash", "k": 3 }'


你应该能看到与之匹配的代码块 `doc_id`, `chunk_id`以及距离。

______________________________________________________________________

### ❓ 带引用的问题提出(rag.qa)```bash
# Fully offline (deterministic mock answer)
python -m src.mcp.rag_server --run-tool rag.qa --input '{ "question": "What problem does Bitcoin aim to solve?", "k": 5, "kg_enrich": true, "use_mock_llm": true }'

➡️ 退货:

  • answer简洁回复(模拟或大型语言模型生成)
  • citations: [ {doc_id, chunk_id, entity_ids, text} ]
  • took_ms, model_used

通过省略(某些内容)来切换到真实的大型语言模型(LLM)合成 use_mock_llm (需要Ollama运行)。


🧠 可选:实体过滤问答```bash

python -m src.mcp.rag_server --run-tool rag.qa --input '{ "question": "How does proof-of-work secure the network?", "entity_ids": ["https://kg.mcp.ai/id/token/bitcoin"], "k": 5, "kg_enrich": true, "use_mock_llm": true }'


这限制了检索仅针对标记有指定知识图谱实体的块。

______________________________________________________________________

### 🧪 运行测试套件```bash
pytest -q

关键测试(全部为离线测试):

  • tests\test_rag_qa.py验证检索归一化和模拟大型语言模型(LLM)模式
  • tests\test_kg_server.py检查KG(知识图谱)连接性(如果GraphDB未运行则跳过)

🩺 健康检查```bash

python -m src.mcp.rag_server --run-tool rag.health
python -m src.mcp.kg_server --run-tool kg.health


期待收集到信息、文件数量以及确认状态。

______________________________________________________________________

### 🧩 MCP协调员/用户界面连接员(可选)

确保您的 `mcp.json` 引用正在运行的服务器:```json
{
"mcpServers": {
"rag": { "command": "python", "args": ["-m", "src.mcp.rag_server"] },
"kg":  { "command": "python", "args": ["-m", "src.mcp.kg_server"] }
}
}

然后,通过您的MCP协调器或Streamlit应用程序进行连接,以交互式地调用 rag.qa 并且 kg.* 工具。


🙏 结束语

GraphRAG MCP是更广泛范围内的一个组成部分 Eeva AI(埃瓦人工智能) 生态系统——一个开放、模块化的智能加密研究与策略生成框架。\
如果没有这个不断推动本地人工智能和知识工程边界的令人惊叹的开源社区,这个项目就不会存在。

如果你觉得这有用:

  • ⭐ 给仓库点赞(或关注) 支持持续发展
  • 🧩(拼图/碎片/谜题) 贡献 改进或新的MCP模块
  • 🧠 表示“大脑”或“思考”的意思。 探索 与其他MCP(Brave API、MongoDB、Telegram等)的集成
  • 💬 分享反馈 — 每一条建议都有助于让系统变得更智能、更快、更可靠

> “知识只有在相互关联时才具有力量。”\
> — Eeva人工智能研究

感谢您成为开源旅程中的一员。 🚀(火箭或快速上升的象征)


常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
GraphDB Desktop 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

GraphDB Desktop 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

GraphDB Desktop 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

GraphDB Desktop 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

GraphDB Desktop 能提供哪些能力?

资料显示能力标签包括 知识图谱、本地AI、Python、问答系统。具体工具清单以官方文档为准。

GraphDB Desktop 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

GraphDB Desktop 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。