Claude Code

Appearance

Graphiti MCP 服务使用指南 ​

概述 ​

Graphiti是一个智能知识图谱管理系统，通过MCP协议为Claude Code提供个性化的偏好记忆、程序记录和事实关系存储能力。它作为AI助手的"长期记忆"，确保个性化和上下文连续性。

核心功能 ​

知识存储类型 ​

  • 偏好设置 (Preferences): 用户的个人喜好和工作习惯
  • 程序记录 (Procedures): 重复性任务的标准化流程
  • 事实关系 (Facts): 实体间的连接和关系信息

主要能力 ​

  • 智能搜索: 基于语义的知识检索
  • 关系映射: 实体间复杂关系的管理
  • 上下文保持: 跨会话的个性化体验
  • 增量学习: 持续优化和知识积累

快速开始 ​

基本工作流程 ​

1. 任务开始前 - 知识检索 ​

bash
# 搜索相关偏好设置
search_nodes(query="开发偏好", entity_type="Preference")

# 搜索相关程序流程  
search_nodes(query="部署流程", entity_type="Procedure")

# 搜索事实关系
search_facts(query="项目依赖关系")

2. 工作过程中 - 知识应用 ​

  • 遵循偏好: 根据发现的个人偏好调整工作方式
  • 执行程序: 严格按照既定程序步骤执行任务
  • 应用事实: 利用实体关系信息指导决策

3. 任务完成后 - 知识存储 ​

bash
# 存储新的偏好或更新
add_episode("用户偏好使用TypeScript而非JavaScript进行前端开发")

# 记录新的程序
add_episode("部署流程：构建->测试->部署到预发布->验证->生产发布")

# 存储事实关系
add_episode("项目A依赖于库B的v2.3版本")

核心工具使用 ​

search_nodes - 节点搜索 ​

用途: 搜索特定类型的知识节点

参数:

  • query: 搜索关键词
  • entity_type: 节点类型 ("Preference" | "Procedure" | 其他)
  • center_node_uuid: 可选，围绕特定节点搜索

使用示例:

python
# 搜索开发相关偏好
search_nodes(
    query="代码风格 TypeScript",
    entity_type="Preference"
)

# 搜索部署相关程序
search_nodes(
    query="部署 构建 测试",
    entity_type="Procedure"
)

search_facts - 事实搜索 ​

用途: 搜索实体间的关系和事实信息

参数:

  • query: 搜索关键词
  • center_node_uuid: 可选，围绕特定节点搜索

使用示例:

python
# 搜索项目依赖关系
search_facts(query="项目依赖 版本")

# 搜索团队成员角色关系
search_facts(query="团队 角色 责任")

add_episode - 知识存储 ​

用途: 存储新的知识或更新现有信息

参数:

  • content: 要存储的知识内容

最佳实践:

python
# 存储偏好设置
add_episode("用户偏好：代码审查时重点关注性能和安全性")

# 存储程序流程
add_episode("Git工作流程：feature分支->PR->代码审查->合并到main")

# 存储事实关系
add_episode("前端项目使用React 18，后端项目使用Node.js 18")

使用场景和案例 ​

场景1: 新项目初始化 ​

bash
# 搜索项目初始化偏好
search_nodes(query="项目初始化 技术栈", entity_type="Preference")

# 搜索项目设置程序
search_nodes(query="项目设置 配置", entity_type="Procedure")

# 应用发现的偏好和程序进行项目初始化
# 存储新的项目配置信息
add_episode("新项目使用Vite+React+TypeScript技术栈")

场景2: 代码审查 ​

bash
# 搜索代码审查偏好
search_nodes(query="代码审查 标准", entity_type="Preference")

# 搜索代码审查程序
search_nodes(query="代码审查 流程", entity_type="Procedure")

# 按照偏好和程序执行审查
# 存储审查发现的问题模式
add_episode("项目中经常出现的性能问题：未优化的循环查询")

场景3: 部署管理 ​

bash
# 搜索部署相关程序
search_nodes(query="部署 CI/CD", entity_type="Procedure")

# 搜索环境配置事实
search_facts(query="生产环境 配置")

# 按程序执行部署
# 更新部署相关信息
add_episode("生产环境部署需要额外的数据库连接池配置")

最佳实践 ​

信息分类原则 ​

偏好设置 (Preferences) ​

  • 个人工作习惯和喜好
  • 代码风格和质量标准
  • 工具和技术栈选择
  • 沟通和协作偏好

程序记录 (Procedures) ​

  • 标准化的工作流程
  • 重复性任务的步骤
  • 质量保证流程
  • 部署和发布流程

事实关系 (Facts) ​

  • 项目技术架构信息
  • 团队成员角色分工
  • 系统依赖关系
  • 配置和环境信息

知识管理策略 ​

1. 主动记录 ​

  • 立即捕获重要的偏好和程序
  • 将长内容拆分为逻辑块
  • 明确标识更新和变更

2. 智能检索 ​

  • 使用具体的搜索关键词
  • 结合节点和事实搜索
  • 优先使用具体匹配

3. 持续优化 ​

  • 定期审查和更新知识
  • 识别和记录行为模式
  • 保持知识的一致性

与Claude Code集成 ​

命令系统集成 ​

Graphiti与所有Claude Code命令无缝集成：

  • 分析命令: 自动检索相关的分析偏好和程序
  • 实现命令: 应用编码风格偏好和开发流程
  • 部署命令: 遵循部署程序和环境配置
  • 文档命令: 使用文档偏好和模板程序

代理系统协作 ​

各专业代理都能利用Graphiti存储的知识：

  • 架构师代理: 使用架构偏好和设计模式
  • 开发代理: 遵循编码标准和开发流程
  • 测试代理: 应用测试策略和质量标准
  • 文档代理: 使用写作风格和文档模板

注意事项 ​

使用限制 ​

  • 搜索查询应具体和相关
  • 避免存储敏感或私人信息
  • 保持知识的准确性和时效性

性能优化 ​

  • 使用具体的entity_type筛选
  • 合理使用center_node_uuid
  • 定期清理过时的知识

安全考虑 ​

  • 不存储密码或密钥信息
  • 注意个人隐私保护
  • 遵循数据保护规范

高级应用 ​

知识图谱优化 ​

  • 建立实体间的层次关系
  • 创建知识分类体系
  • 实现智能推荐和联想

团队协作增强 ​

  • 共享团队偏好和程序
  • 建立团队知识库
  • 实现协作流程标准化

个性化提升 ​

  • 基于历史数据优化建议
  • 预测用户需求和偏好
  • 自动化常见任务流程

Graphiti MCP服务使用指南 - 您的AI助手记忆系统

Claude Code 使用指南

Copyright © 2025