返回市场
涂鸦图编辑器

涂鸦图编辑器

作者:rawr-ai82 星标更新:2025-08-07

项目介绍

Graphiti MCP Server

getzep/graphiti示例的分支,专注于开发者体验和多项目支持。Graphiti从文本中提取实体和关系,并将其存储在Neo4j中。此仓库添加了一个CLI,可以在Docker中启动一个根服务器以及特定项目的MCP服务器,使得多个知识图谱可以共享同一个数据库。

快速开始

  1. 安装并克隆
    pipx install 'git+https://github.com/rawr-ai/mcp-graphiti.git'
    git clone https://github.com/rawr-ai/mcp-graphiti.git
    cd mcp-graphiti
    cp .env.example .env  # 填写Neo4j凭证和你的OpenAI密钥
    
  2. 启动服务
    graphiti compose   # 生成docker-compose.yml并更新.cursor/mcp.json
    graphiti up -d
    
    根服务器运行在端口8000;项目容器从8001开始。
  3. 创建一个项目
    cd /path/to/my-kg
    graphiti init my-kg        # 写入ai/graph/mcp-config.yaml
    # 在ai/graph/entities/下添加实体定义
    
    从任何地方重新运行graphiti compose && graphiti up -d以启动其容器。

一旦运行起来,你可以:

  • 检查http://localhost:8000/graphiti/status
  • 将兼容MCP的工具连接到http://localhost:800{N}/sse
  • 使用.env中的凭证通过http://localhost:7474浏览Neo4j。

安全说明

如果NEO4J_PASSWORD仍然是password,除非设置GRAPHITI_ENV=dev,否则服务器拒绝启动。生产环境中始终使用强密码。

为什么是这个分支?

上游仓库假设每个compose文件对应一个服务器。这里,单个compose文件管理许多项目服务器,它们共享Neo4j。每个服务都有自己的group_id、实体和模型,因此即使运行在同一数据库上,项目之间仍然保持隔离。

高亮功能

  • 项目隔离 – 不同的提取规则或模型永远不会冲突。
  • 编辑器自动发现 – 端口信息写入.cursor/mcp.json
  • 故障隔离 – 错误提示只会重启其容器。
  • 热重载 – 调整项目的配置后,运行graphiti reload <container>

如果你只需要根服务器,可以将mcp-projects.yaml留空。

危险区域

设置NEO4J_DESTROY_ENTIRE_GRAPH=true会在下次运行graphiti up时清除所有项目。谨慎使用。

贡献

欢迎提交PR和报告问题。

© 2025 rawr-ai • MIT License