java项目切片分析
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"java-repo-skimmer": {
"args": [
"-y",
"@jokeran/java-repo-skimmer@latest"
],
"autoApprove": [
"java_index_repos",
"java_find_symbol",
"java_get_call_graph",
"java_project_overview",
"java_trace_symbol",
"java_get_file_outline",
"java_get_code_slice",
"java_search_text",
"java_list_endpoints",
"java_trace_spring_bean",
"java_method_impact_analysis",
"java_watch_repos",
"java_stop_watcher",
"java_watcher_status",
"java_index_health",
"java_list_indexed_repos",
"java_explain_index_status",
"java_clear_index",
"java_compact_index"
],
"command": "npx",
"disabled": false,
"timeout": 180
}
}
}
服务介绍
stdio + MCP(JSON-RPC),无需部署服务器。
核心分析服务使用 Java 实现,兼容 Java 8。
支持本地源码启动,也支持 npm wrapper 发布为 npx @jokeran/java-repo-skimmer@latest。
支持多仓索引、增量刷新、repo-local SQLite 缓存、缓存清理和索引健康解释。
heuristic 模式适合日常快速定位,precise 模式使用 JavaParser/SymbolSolver 做更准确的调用边。
precise 模式会自动尝试加载本机 Maven 缓存中的第三方 jar;失败会降级,不要求用户安装 Maven。
支持显式开启/关闭 watcher;默认无后台监听,watcher 仅在当前 MCP 进程内生效。
macOS 下 watcher 默认带 30 秒轮询兜底,避免 WatchService 漏事件导致索引过期。
支持低内存模式,可通过环境变量收缩索引 worker 并在结果中回显当前模式。
内置 Spring 感知工具,可直接提取接口路由、参数分类、Bean 定义和依赖关系。
无变更热增量索引支持 fast_reuse 快速复用旧索引,避免每次都重新扫描解析全仓。
java_search_text 已接入 repo-local SQLite FTS5,适合搜索 SQL、常量、字段名和中文业务词。