jcodemunch-mcp

翻代码省 95% 的钱,AI 随便查不心疼。

开源 🏷️基础免费,高级付费 ✅ 目前可打开 编程开发 🍴 复刻 373 🐛 待处理 5 👀 关注 19
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 2836
维护状态 活跃
是否开源 开源
定价模式 🏷️基础免费,高级付费 支持限时试用 · 提供免费额度,付费解锁更多功能,具体价格需查看官网。

项目预览

jcodemunch-mcp 项目界面预览图
图片来源:项目官网

项目数据

分类编程开发
开发团队jgravelle
定价模式🏷️基础免费,高级付费
价格说明提供免费额度,付费解锁更多功能,具体价格需查看官网。
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型ai-coding,ast,claude,claude-code,cline,code-intelligence,codex,context-window,copilot,cursor,developer-tools,gemini-cli,llm,mcp,mcp-server,model-context-protocol,opencode,token-optimization,tree-sitter,windsurf
GitHub 星标★ 2836
上线时间2026-02-09 00:00:00
代码更新2026-11-08
仓库体积44.5 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数7

项目介绍

将代码探索的 AI Token 成本削减 95% 以上。作为领先的 MCP 服务器,它借助 tree-sitter AST 实现符号级精确定位的 GitHub 代码检索,兼容 Claude Code、Cursor 及任意 MCP 客户端,已累计节省超过 3130 亿 Token。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2836

使用教程

难度:入门 约 5 分钟 部署方式:命令行工具 6 步

环境要求

  • 需要 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

关键配置

配置项必填说明示例
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···

★ 261 2026-08-09
awesome-codex-skills 开源

精选 Codex 技能,让 AI 编程自动化落地

A curated list of practical Codex skills for automating workflows across the Codex C···

★ 17249 2026-08-09
mcp-agent-langchainjs 开源

用 LangChain.js 加 MCP 搭一个能点汉堡的 AI 智能体

Serverless AI agent using LangChain.js and Model Context Protocol (MCP) integration ···

★ 205 2026-11-07
Integuru 开源

逆向内部 API,自动生成集成代码,无需官方权限

The first AI agent that builds permissionless integrations through reverse engineeri···

★ 4793 2026-08-09
BitFun 开源

用 Rust 驱动的桌面 AI 代理,让复杂工作自动化一步到位

OpenBitFun combines a high-performance agent runtime written in Rust with a polished···

★ 3966 2026-08-09
agentswarms 开源

把AI助手和数据分析装进一个平台,一句话搞定业务洞察

Unified Agentic AI and Data Platform

★ 295 2026-08-09
WhyBuddy 开源

输入产品想法,AI 帮你系统推演验证

A Simple and Universal Product Rehearsal Engine, Speccing Anything. 简洁通用的产品推···

★ 380 2026-08-09
nocturne_memory 开源

给 AI 装上永久记忆,告别失忆,随时回滚查看。

A lightweight, rollbackable, and visual Long-Term Memory Server for MCP Agents. Say ···

★ 1425 2026-08-09
design-os-3d-blender 开源

让 AI 代理稳定驱动 Blender 建模并过打印门禁

AI agent operating system for Blender 5.2: bpy knowledge base, AGENT_OK execution co···

★ 112 2026-10-21