java项目切片分析

jokeran/java-repo-skimmer
0 Stars 13 次浏览 更新于 2026-08-23

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、常量、字段名和中文业务词。

相关 MCP 服务