项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2836
技术标签
使用教程
环境要求
- 需要 uv/uvx(README 用 uvx 按需拉取并运行服务器,无需提前安装包)
- 一个 MCP 兼容客户端:Claude Code、Cursor、VS Code、Codex CLI、Windsurf、Continue 等
- 若客户端不是 Claude Code,需参考仓库 CLIENTS.md 中对应的客户端配置
安装与启动步骤
-
1注册 MCP 服务器
在 Claude Code 中把 jcodemunch 注册为用户级 MCP 服务器;uvx 会按需拉取并运行,无需单独安装。
claude mcp add -s user jcodemunch -- uvx jcodemunch-mcp -
2安装到 PATH(可选)
希望 jcodemunch-mcp 常驻 PATH(强制钩子需要)时,先 uv tool install,再改用可执行名注册。
uv tool install jcodemunch-mcp claude mcp add -s user jcodemunch jcodemunch-mcp -
3写入引导指令
光注册只是让工具可用,不会改掉 agent 通读整文件的习惯;在 CLAUDE.md 加一行强制其走 jcodemunch。
Call the jcodemunch_guide tool and strictly follow its instructions. -
4按仓库做覆盖配置
在仓库根目录放 .jcodemunch.jsonc 作为叠加层,只写需要覆盖的键,未写的键回落到全局与内置默认值。
{ "max_file_size": 1048576, "languages": ["python", "typescript", "racket"] } -
5索引并提问
在 agent 里先让它索引本仓库,再问一个具体问题(如认证函数),应通过 search_symbols 与 get_symbol_source 只返回数十行。
-
6使用预置包(可选)
热门框架可跳过首次索引,直接安装预构建 starter packs;免费包不需要许可证。
jcodemunch-mcp install-pack --list
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
max_file_size | 否 | 单文件索引大小上限,可按仓库调大或调小。 | 1048576 |
languages | 否 | 限定参与索引的语言列表,减少无关解析。 | ["python", "typescript", "racket"] |
如何确认成功
让 agent 调用 get_session_stats,能报出本次会话服务与节省的 token 数即表示生效。
常见问题
Q:需要先安装 jcodemunch-mcp 吗?
A:不需要。uvx jcodemunch-mcp 会按需拉取并运行服务器;只有想让它在 PATH 中(如强制钩子)才用 uv tool install。
Q:支持哪些客户端?
A:README 列出 Claude Code、Cursor、VS Code、Codex CLI、Windsurf、Continue,以及任何 MCP 兼容客户端;其它客户端的配置见 CLIENTS.md。
Q:装好了,为什么 agent 还是整文件通读?
A:注册只是让工具可用,不会改变通读习惯。需在 CLAUDE.md 加一行让它调用 jcodemunch_guide 并严格遵守其指示。
Q:能跳过首次索引吗?
A:可以,热门框架有预构建 starter packs,执行 jcodemunch-mcp install-pack --list 查看,免费包无需许可证。
Q:配置写在哪里?
A:全局在 ~/.code-index/config.jsonc,单仓库可在根目录放 .jcodemunch.jsonc 做叠加覆盖,声明键优先。
注意事项
- 个人使用免费;用于营利需购买商业许可。
- README 未给出 Windows 或特定 Python 版本要求,按 uvx 的运行方式使用即可。
- 本地语义搜索、按提供商生成 AI 摘要等可选增强会引入额外依赖,详见 QUICKSTART.md 与 SECURITY.md。
核心亮点
- 基于 tree-sitter AST 实现符号级代码检索,精度远超传统文本搜索,可大幅减少无效 token 消耗
- 已节省 313B+ tokens,实际效果经过大量用户验证,对 Claude Code、Cursor 等 MCP 客户端兼容性好
- 针对 AI 编码场景深度优化,能显著降低代码探索成本,适合大仓库或频繁上下文切换的开发者
不足之处
- 文档/社区待观察
- 依赖 tree-sitter 语法覆盖,对冷门语言或动态特性支持可能有限
适用场景
- 大型代码库中快速定位符号定义与引用,减少 AI 上下文窗口压力
- 在 Claude Code、Cursor 等 AI 编程工具中作为 MCP 服务器,优化代码检索效率
- 需要精确代码结构分析的自动化工具或 CI 流程集成
替代项目
GitHub Copilot、Sourcegraph、Continue
上一篇:pro-workflow
下一篇:nanocoder
同类项目推荐
xint
开源
本地命令行玩转 X 数据,搜索监控分析导出一步到位
Local-first X Intelligence CLI for search, monitoring, analysis, exports, OAuth acti···
awesome-codex-skills
开源
精选 Codex 技能,让 AI 编程自动化落地
A curated list of practical Codex skills for automating workflows across the Codex C···
mcp-agent-langchainjs
开源
用 LangChain.js 加 MCP 搭一个能点汉堡的 AI 智能体
Serverless AI agent using LangChain.js and Model Context Protocol (MCP) integration ···
Integuru
开源
逆向内部 API,自动生成集成代码,无需官方权限
The first AI agent that builds permissionless integrations through reverse engineeri···
BitFun
开源
用 Rust 驱动的桌面 AI 代理,让复杂工作自动化一步到位
OpenBitFun combines a high-performance agent runtime written in Rust with a polished···
agentswarms
开源
把AI助手和数据分析装进一个平台,一句话搞定业务洞察
Unified Agentic AI and Data Platform
WhyBuddy
开源
输入产品想法,AI 帮你系统推演验证
A Simple and Universal Product Rehearsal Engine, Speccing Anything. 简洁通用的产品推···
nocturne_memory
开源
给 AI 装上永久记忆,告别失忆,随时回滚查看。
A lightweight, rollbackable, and visual Long-Term Memory Server for MCP Agents. Say ···
design-os-3d-blender
开源
让 AI 代理稳定驱动 Blender 建模并过打印门禁
AI agent operating system for Blender 5.2: bpy knowledge base, AGENT_OK execution co···
