jcodemunch-mcp

环境要求

• 需要 uv/uvx（README 用 uvx 按需拉取并运行服务器，无需提前安装包）
• 一个 MCP 兼容客户端：Claude Code、Cursor、VS Code、Codex CLI、Windsurf、Continue 等
• 若客户端不是 Claude Code，需参考仓库 CLIENTS.md 中对应的客户端配置

安装与启动步骤

1. 1注册 MCP 服务器

   在 Claude Code 中把 jcodemunch 注册为用户级 MCP 服务器；uvx 会按需拉取并运行，无需单独安装。

   claude mcp add -s user jcodemunch -- uvx jcodemunch-mcp

   复制

2. 2安装到 PATH（可选）

   希望 jcodemunch-mcp 常驻 PATH（强制钩子需要）时，先 uv tool install，再改用可执行名注册。

   uv tool install jcodemunch-mcp
   claude mcp add -s user jcodemunch jcodemunch-mcp

   复制

3. 3写入引导指令

   光注册只是让工具可用，不会改掉 agent 通读整文件的习惯；在 CLAUDE.md 加一行强制其走 jcodemunch。

   Call the jcodemunch_guide tool and strictly follow its instructions.

   复制

4. 4按仓库做覆盖配置

   在仓库根目录放 .jcodemunch.jsonc 作为叠加层，只写需要覆盖的键，未写的键回落到全局与内置默认值。

   {
     "max_file_size": 1048576,
     "languages": ["python", "typescript", "racket"]
   }

   复制

5. 5索引并提问

   在 agent 里先让它索引本仓库，再问一个具体问题（如认证函数），应通过 search_symbols 与 get_symbol_source 只返回数十行。

6. 6使用预置包（可选）

   热门框架可跳过首次索引，直接安装预构建 starter packs；免费包不需要许可证。

   jcodemunch-mcp install-pack --list

   复制

关键配置

如何确认成功

让 agent 调用 get_session_stats，能报出本次会话服务与节省的 token 数即表示生效。

常见问题

注意事项

• 个人使用免费；用于营利需购买商业许可。
• README 未给出 Windows 或特定 Python 版本要求，按 uvx 的运行方式使用即可。
• 本地语义搜索、按提供商生成 AI 摘要等可选增强会引入额外依赖，详见 QUICKSTART.md 与 SECURITY.md。