Skip to content
Back to search

atlasgraph-mcp

AtlasGraph MCP server/client integration and GraphRAG source archive

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wanzhenxia39-spec--atlasgraph-mcp/badge.svg)](/listings/wanzhenxia39-spec--atlasgraph-mcp)

HTML

<a href="/listings/wanzhenxia39-spec--atlasgraph-mcp"><img src="/api/listings/wanzhenxia39-spec--atlasgraph-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 60 lines
  1. # AtlasGraph MCP server and client
  2. 这是 GraphRAG 项目的个人实习开发归档,重点展示 AtlasGraph 图数据库的 MCP 服务端、客户端和连续查询流程。GraphRAG 基础代码来自原项目团队;本仓库不是海致的官方产品发布,也不表示底层 GraphRAG 或 Text2Cypher 能力由仓库维护者独立开发。
  3. ## 已有能力
  4. - 使用 FastMCP 注册 4 类工具:`get_schema`、`text2cypher`、`execute_cypher`、`get_multi_hop_paths`。
  5. - 通过 SSE 建立 MCP 客户端会话,发现工具、发起调用并读取结果。
  6. - 结合模型输出完成工具选择、参数解析、子问题拆解与结果汇总。
  7. - 使用 `Context` 维护会话内工具调用历史。
  8. - 在 FastAPI 主服务中提供 `/sse` 与 `/messages` 通信入口。
  9. - 保留原项目的文档处理、存储适配和多种 RAG 查询模式。
  10. ## 代码位置
  11. | 位置 | 作用 |
  12. | --- | --- |
  13. | `src/rag/mcp/server.py` | MCP 工具与 SSE 服务 |
  14. | `src/rag/mcp/client.py` | 连接、工具发现、调用和查询流程 |
  15. | `src/rag/agent/atlas_mcp_workflow.py` | 单次请求驱动的多步骤查询示例 |
  16. | `src/rag/prompt/mcp_prompt.py` | 工具选择与参数生成提示词 |
  17. | `src/rag/prompt/split_query_prompt.py` | 子问题拆解提示词 |
  18. | `src/rag/common/context.py` | 上下文和工具调用历史 |
  19. | `src/rag/service/service.py` | FastAPI 主服务及 MCP 通道挂载 |
  20. | `src/rag/test/` | 上传、问答和建库联调示例 |
  21. ## 运行前置条件
  22. 该代码归档依赖外部服务,不是独立数据库发行包。运行前需要自行准备:
  23. 1. 与 `driver3` 接口兼容的 AtlasGraph 实例和 Python SDK。
  24. 2. 与代码请求格式兼容的大模型、Embedding 服务;图片处理还需多模态服务。
  25. 3. 项目所需 Python 依赖。源码包含 Python 3.12 的 f-string 写法;历史依赖清单位于 `docker/tmpfiles_root/requirements*.txt`,MCP SDK 需要另外安装并锁定兼容版本。
  26. AtlasGraph SDK wheel、字体和公司内部基础镜像不随本仓库分发。Docker 文件保留了原有构建方式,需要自行准备兼容基础镜像以及 SDK,并传入 `BASE_IMAGE` 构建参数。旧版依赖和示例仍需在实际运行环境验证。
  27. ## 配置与启动
  28. ```sh
  29. cp config/config.example.yaml config/config.yaml
  30. # 编辑 config/config.yaml,填写自己的数据库与模型服务配置。
  31. export PYTHONPATH="$PWD/src"
  32. python src/rag/service/service.py --rag_config config/config.yaml
  33. ```
  34. 主服务启动后,可以使用 SSE 客户端连接:
  35. ```sh
  36. python src/rag/mcp/client.py --rag_config config/config.yaml http://127.0.0.1:21032/sse
  37. ```
  38. 示例问题:获取指定图库的 Schema,然后生成查询 Entity 节点的 Cypher 并执行。
  39. 真实服务配置应只保存到被 Git 忽略的 `config/config.yaml`。旧的实体对齐索引若调用 ZhipuAI,需要在本机另行设置 `ZHIPUAI_API_KEY`。
  40. ## 归档说明
  41. 此公开版本从原工作目录生成新的源码快照,未携带旧 Git 历史、内部 CI 配置、固定凭据、内部服务地址、个人周报、运行日志、缓存、SDK wheel 和字体。连接地址已改成本机示例,数据库默认密码已清空。核心 Python 代码没有在本次归档中进行功能重构。
  42. 本次归档只验证代码语法和发布文件;未连接真实 AtlasGraph 或模型服务,也未宣称全量测试、类型检查或生产验证已经通过。现有 MCP 工作流为串行示例,Resources、持久化执行、审批和恢复机制均不在当前实现范围内。历史代码中的多模态配置键判断等兼容问题尚未在本次归档中修复,启用相关能力前应单独验证。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.