1. 服务概述一句话简介为编码代理提供结构化记忆的MCP服务通过AST构建代码知识图谱实现毫秒级查询和零令牌浪费服务名称memtrace版本号v0.3.22开发者/提供方syncable-dev协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点结构化知识图谱基于AST构建代码知识图谱函数、类、接口、API端点作为节点具有确定性的类型关系双时态版本历史每个符号携带完整的版本历史支持6种评分算法影响、新颖性、近期性、方向性、复合、概览跨服务API拓扑映射仓库之间的HTTP调用图检测哪些服务调用哪些端点25 MCP工具包括搜索发现、关系分析、影响分析、代码质量、时态分析、图算法、API拓扑等12个代理技能自动触发的技能包括搜索、关系、演化、影响、质量、架构、API、索引等混合搜索Tantivy BM25 向量嵌入 倒数排名融合平均查询延迟低于8毫秒社区检测Louvain算法自动识别架构模块本地运行完全在本地机器上运行源代码不会离开本地3. 使用场景描述该服务适合在什么情况下使用代码库探索新项目概览、理解架构、追踪依赖关系影响分析评估代码变更的影响范围、分析破坏半径事件调查根本原因分析、追踪问题源头重构指导清理技术债务、识别死代码、复杂度热点分析代码质量分析查找死代码、计算圈复杂度、识别复杂度热点时态分析追踪代码演化历史、分析架构变化API拓扑分析跨仓库服务依赖分析、API端点发现4. 接入方式4.1 服务端点Memtrace作为本地服务运行提供以下端点Web UIlocalhost:3030- 图形化界面探索图谱、追踪依赖、发现死代码、可视化架构MCP Server通过标准MCP协议提供服务Claude和Cursorv2.4自动识别4.2 认证与权限Memtrace目前处于私有测试阶段需要加入等待列表访问 memtrace.io 加入等待列表许可证验证是唯一的网络流量所有解析、图构建、嵌入生成和查询都在本地进行4.3 数据格式服务支持以下数据格式输入源代码文件支持多种编程语言输出结构化符号元数据、关系图谱、时态数据查询自然语言查询、符号名称、图遍历查询4.4 服务器配置在MCP客户端配置中添加服务{ mcpServers: { memtrace: { command: memtrace, args: [start] } } }5. 接口定义5.1 搜索与发现工具工具名称描述参数find_code混合BM25 语义搜索使用RRF融合query: 查询字符串find_symbol精确/模糊名称匹配支持Levenshtein距离name: 符号名称5.2 关系分析工具工具名称描述返回值analyze_relationships分析调用者、被调用者、层次结构、导入关系关系图谱get_symbol_context360度全方位视图完整符号上下文5.3 影响分析工具工具名称描述功能get_impact破坏半径分析带风险评级评估变更影响detect_changes差异到符号的范围映射识别变更范围5.4 代码质量工具工具名称描述find_dead_code零调用者检测识别未使用代码find_most_complex_functions复杂度热点识别calculate_cyclomatic_complexity每个符号的圈复杂度评分get_repository_stats仓库级别的指标统计5.5 时态分析工具工具名称描述评分模式get_evolution6种评分模式分析代码演化compound, impact, novel, recent, directional, overviewget_timeline完整的符号版本历史版本时间线6. 快速开始6.1 环境要求最低配置4 CPU核心8 GB RAM5 GB可用磁盘空间Node.js 18Git推荐配置大型monorepo8 CPU核心16-32 GB RAM10-20 GB可用磁盘空间注意首次运行时CPU/RAM占用较高无需GPU6.2 示例代码安装和启动# 全局安装memtrace包含二进制文件 12个技能 MCP服务器 npm install -g memtrace # 从项目根目录启动自动启动图数据库并开始索引 memtrace start使用MCP工具查询代码# 查找符号 find_symbol(nameUserService) # 分析关系 analyze_relationships(symbolUserService.login) # 获取影响范围 get_impact(symbolUserService.login) # 查找死代码 find_dead_code() # 获取演化历史 get_evolution(modecompound)7. 注意事项重要提示私有测试Memtrace目前处于私有测试阶段必须在 memtrace.io 加入等待列表才能使用隐私保护所有处理完全在本地进行源代码不会离开本地机器。唯一的网络流量是许可证验证和聚合使用统计遥测数据默认启用崩溃/错误/应用启动事件的遥测已清理不包含源代码、文件内容、符号名称。可通过MEMTRACE_TELEMETRYoff禁用性能要求首次索引时CPU和RAM占用较高建议在资源充足的机器上运行大型代码库功能状态核心索引和结构搜索稳定时态功能演化评分、时间线回放功能正常但可能有粗糙边缘社区支持可在 Discord 加入讨论、提问和关注测试更新性能基准v0.3.22精确符号查找准确率96.6%1000个查询平均查询延迟0.07毫秒内存占用26.2 MB索引时间约500毫秒mempalace/ 13.6秒Django增量更新时间42.5毫秒p95
部署)
