SocratiCode功能全景图：一文掌握15个MCP工具，从混合语义搜索到交互式依赖图谱

SocratiCode功能全景图一文掌握15个MCP工具从混合语义搜索到交互式依赖图谱【免费下载链接】SocratiCodeEnterprise-grade (40m LOC) codebase intelligence, zero-setup, local private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis call-flow, interactive HTML viewer, cross-project branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.项目地址: https://gitcode.com/gh_mirrors/so/SocratiCodeSocratiCode 是一款面向 AI 助手的开源本地代码库智能引擎以零配置的 MCPModel Context Protocol服务器形式运行它提供混合语义搜索、多语言依赖图谱、符号级影响分析blast radius与调用流追踪、交互式 HTML 依赖图谱以及数据库/API/基础设施知识的可搜索索引。本文用一篇完整指南带你掌握它的 15 个核心 MCP 工具。 官方实测在 VS Code 的 245 万行代码仓库上相比基于 grep 的探索SocratiCode 消耗少 61% 的上下文 token、少 84% 的工具调用且速度快 37 倍使用 Claude Opus 4.6 实测。什么是 SocratiCode一句话定位一句话你的 AI 会读代码而 SocratiCode 让它真正理解代码。它的架构可以概括为三层层能力对应工具 索引层自动分块 本地嵌入Docker 托管 Qdrant 与 Ollama全程私有codebase_index/codebase_update 检索层稠密向量 BM25 关键词的混合语义搜索RRF 融合排序codebase_search 图谱层基于 ASTast-grep的多语言依赖图 符号级调用图codebase_graph_*/codebase_impact所有组件默认本地私有运行无需 API Key代码不离开你的机器已在大企业级仓库4000 万行上经过验证索引支持断点续传、文件监听自动增量更新。上手准备3 行配置接入你的 AI 宿主SocratiCode 要求 Node.js 18.17 和 Docker托管本地 Qdrant Ollama。任何支持本地 stdio MCP 服务器的宿主Claude Code、Cursor、Cline、Zed、Gemini CLI、VS Code 等都可以直接接入仓库内置了完整配置 mcp.json{ mcpServers: { socraticode: { command: npx, args: [-y, --prefer-online, socraticodelatest] } } }各宿主的详细安装路径见官方快速指南docs/guides/README.md覆盖 Claude Code、Codex、VS Code、Cursor、Gemini CLI、Continue、Cline、Zed、OpenCode 九大宿主另有纯本地索引指南、团队共享索引与跨仓库搜索等专题。工具全景15 个核心工具 11 个辅助工具一览SocratiCode 共注册了26 个 MCP 工具全部定义在 src/index.ts 中按职责分为六大类。本文精讲其中15 个核心工具#工具名一句话功能分类1codebase_index后台全量索引项目立即返回 索引2codebase_update只重索引变更文件的增量更新 索引3codebase_status查看索引进度、分块数、监听状态 索引4codebase_watch启动/停止文件监听自动保鲜索引 索引5codebase_stop优雅停止索引保留检查点可续传 索引6codebase_remove彻底移除项目索引 索引7codebase_search混合语义搜索RRF 融合排序 检索8codebase_graph_build构建多语言依赖图谱 图谱9codebase_graph_query查某文件的 import / 被依赖关系 图谱10codebase_graph_stats图谱统计连通度、孤儿文件、环数 图谱11codebase_graph_circular一键找出循环依赖链 图谱12codebase_graph_visualizeMermaid 或交互式 HTML 图谱 图谱13codebase_impact符号级爆炸半径影响分析 影响14codebase_flow从入口点追踪执行调用流 影响15codebase_symbol单个符号的 360° 全景视图 影响其余 11 个辅助工具codebase_symbols、codebase_graph_status、codebase_graph_remove、4 个codebase_context_*、codebase_health、codebase_list_projects、codebase_about、codebase_prune会在下文分类小节中一并介绍。索引六件套从一键索引到自动保鲜一键全量索引codebase_index首次使用时只需对 AI 说Index this codebase。codebase_index会在后台运行自动拉起 Qdrant 与 Ollama 容器、下载本地嵌入模型、按 AST 感知的方式分块代码并向量化。调用立即返回不阻塞对话实现见 src/tools/index-tools.ts。⏱️ 参考速度MacBook Pro M4 上首次索引 300 万行代码不到 10 分钟索引中断也不怕——进度有检查点重新调用即可从断点续传。增量更新与状态查询codebase_update只处理变更文件适合手动快照模式下随时刷新索引。codebase_status返回分块数、索引进度百分比、上一次操作耗时、文件监听状态是轮询进度 100% 的仪表盘见 src/tools/query-tools.ts。文件监听索引永不过期codebase_watchstart / stop / status监听项目目录的每一次文件变更并自动增量更新索引。默认模式下服务器启动时还会自动恢复已索引项目的监听与增量补差——你通常什么都不用做。安全阀codebase_stop 与 codebase_removecodebase_stop会在当前批次完成并写好检查点后停止已完成的进度全部保留codebase_remove则按停监听 → 取消索引 → 等待图谱构建 → 删集合的完整安全序卸载索引避免删除时产生脏数据实现细节见 src/tools/index-tools.ts。混合语义搜索codebase_search 的深度检索这是 SocratiCode 的招牌工具也是少 84% 工具调用的核心来源。原理稠密向量语义相似度与 BM25精确关键词两路召回用 RRFReciprocal Rank Fusion融合排序——既找得到语义相关的代码也不会漏掉名字完全匹配的符号。核心参数参数作用query自然语言查询如 authentication middlewarelimit/minScore结果数量默认 10与最低 RRF 分数过滤默认 0.10fileFilter/languageFilter按相对路径或语言如python过滤includeLinked⭐ 跨项目搜索同时检索.socraticode.json中链接的其他项目结果带项目标签实现位于 src/tools/query-tools.ts。配合先搜索、后读文件的 Agent 策略插件已内置该技能见 skills/codebase-exploration/SKILL.mdAI 可以用一次搜索替代几十次文件试探。多语言依赖图谱谁依赖谁一目了然依赖图谱基于ast-grep 静态分析覆盖 18 种语言刻画文件级 import/require/export 关系构建引擎在 src/services/code-graph.tscodebase_graph_build后台构建依赖图同样可轮询进度codebase_index完成后也会自动触发构建通常无需手动操作。codebase_graph_query查询单个文件import 了谁、被谁 import双向列出适合快速定位文件的上下游。codebase_graph_stats总文件数、边数、平均依赖度、循环依赖链数量、Top 10 最连通文件、孤儿文件清单、语言分布——一张代码结构体检表。codebase_graph_circular直接输出循环依赖链A → B → C → A重构前的排雷利器。交互式 HTML 图谱在浏览器里把玩依赖关系codebase_graph_visualize是本文最出片的工具支持两种模式mermaid默认返回按语言着色、高亮循环依赖的 Mermaid 文本图可直接在聊天/编辑器中渲染interactive生成一个完全自包含、可离线打开的 HTML 页面内置 Cytoscape.js Dagre见 src/services/graph-visualize-html.ts并自动在浏览器中打开。交互模式的能力清单 点击节点 → 侧边栏显示 import/被依赖/符号列表 右键节点 → 高亮其爆炸半径反向传递闭包 顶部一键切换文件图 ↔ 符号级调用图 实时搜索过滤 六种布局Dagre / 力导向 / 同心圆 / BFS / 网格 / 圆形 一键导出 PNG 分享无头环境可设open: false仅取文件路径逻辑见 src/tools/graph-tools.ts。符号级影响分析与调用流重构前的保险丝文件级图谱回答谁 import 了谁符号级图谱则深入函数/类——这 4 个工具是复杂重构的底气codebase_impact返回目标文件或符号的BLAST RADIUS——改动它哪些文件、哪些函数可能坏掉。目标参数是多态的传路径走文件模式传符号名如validateUser走符号模式可用depth控制回溯跳数默认 3最大 10。重命名、删代码前必调。codebase_flow从入口点正向追踪执行流——这段代码会调用到哪些下游不带参数时自动发现入口点孤儿出边、main()、框架路由、测试等见 src/services/graph-entrypoints.ts带参数则返回完整调用树。codebase_symbol单个符号的 360° 视图——定义位置、类型、调用者、被调用者及置信度动手修改前先看懂它。codebase_symbols辅助列出某文件的全部符号或按名字跨项目搜索符号是钻取单个符号前的发现层。由于这些难题已被 SocratiCode 预计算较小的模型也能完成原本需要顶级推理模型的架构级任务进一步省下 token 成本工具定义见 src/index.ts。上下文工件把数据库 Schema、API 规范也变成可搜索知识源码之外的项目知识同样重要。SocratiCode 支持通过.socraticodecontextartifacts.json声明上下文工件数据库 Schema、API 规范、基础设施配置、架构文档并配了 4 个专属工具实现见 src/tools/context-tools.ts工具用途codebase_context_search语义搜索工件如 tables related to billing、authentication endpoints首次使用自动索引、自动检测过期工件codebase_context列出所有已声明工件及其索引状态codebase_context_index手动重索引全部工件codebase_context_remove移除项目的工件索引从此 AI 不仅能读懂你的代码还能理解你的数据库和 API。诊断与管理让运维也交给 AI工具场景codebase_health一键体检Docker、Qdrant 容器、Ollama、嵌入模型是否健康排障首选codebase_list_projects列出向量库中所有已索引项目codebase_about让 AI 自己复读所有工具用途新宿主接入后的快速自检codebase_prune清点存储中的项目身份与资源默认只报告删除需精确身份 确认令牌 无远端写入者确认多重保险新手三步工作流索引 → 搜索 → 分析索引对 AI 说 Index this codebase然后用 What is the codebase index status? 轮询到 100%图谱随后自动构建。搜索之后直接用自然语言提问——数据库连接在哪里初始化让 AI 走搜索而不是逐个读文件。分析动代码前让它跑codebase_impact看爆炸半径或生成interactive图谱在浏览器里可视化检查。文件监听默认开启此后索引随代码自动保鲜三步只需首次。核心源码导读想深入原理按模块定位MCP 服务器入口与全部 26 个工具注册src/index.ts索引生命周期后台索引/增量/取消/监听src/tools/index-tools.ts混合搜索与状态查询src/tools/query-tools.ts依赖图谱、影响分析、可视化src/tools/graph-tools.ts图谱构建引擎ast-grep、循环检测、统计src/services/code-graph.ts代码分块与向量化src/services/chunk-split.ts、src/services/embeddings.ts上下文工件索引src/services/context-artifacts.ts各宿主安装与进阶配置docs/guides/README.md总结SocratiCode 的 26 个 MCP 工具围绕一条主线展开先零配置建好本地索引与图谱再让 AI 用混合语义搜索和符号级分析看懂你的代码。15 个核心工具各司其职——codebase_index一键启动、codebase_search混合检索、codebase_graph_visualize交互式图谱、codebase_impact重构保险丝、codebase_flow调用流追踪辅以上下文工件把数据库和 API 知识一并纳入检索。对新手而言记住索引 → 搜索 → 分析三步再加上本地私有、断点续传、自动保鲜三大特性就足以把它变成你 AI 编程工作流里的常驻基础设施。【免费下载链接】SocratiCodeEnterprise-grade (40m LOC) codebase intelligence, zero-setup, local private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis call-flow, interactive HTML viewer, cross-project branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.项目地址: https://gitcode.com/gh_mirrors/so/SocratiCode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考