内容
`chop` 是 AI 上下文打包器:一条命令将代码库转换为适用于 Claude、GPT、Windsurf 等编码代理的单个结构化上下文块。
```sh
chop src/
chop . --format gpt --tokenizer gpt
chop . --include '**/*.rs' --exclude 'tests/**copy
chop . --stats-only
chop . --focus 'authentication' --max-tokens 60000
```
它遵循 `.`,跳过版本控制目录、依赖构建输出、二进制文件和大于 2 MiB 的文件使用与 Claude 兼容;GPT Markdown 和纯文本的。
## 默认安全
`chop` 设计为代理可以在不熟悉的存储库:
- 默认情况下,为 100,000 个。
- 源代码和项目配置优先在预算下。
- `-- 提升与任务、功能或符号相关的文件。
- 生成的文件、缓存、日志、存档资产和构建输出被丢弃。
- `.env`、凭证、私钥、签名存储和类似文件受到保护。
- 排除存储库 指令以降低提示注入- 每个响应都、已选、已省略生成和敏感的文件计数。
--only` 仅列100 个最大的合格文件。
使用 `--max-tokens` 更改预算。值为 `0` 禁 限制,仅应有意敏感文件需要明确的 `--` 选项。
存储库代理指令需要 `--allow-agent-config`。
## 安装
无需安装 Rust。
macOS 和 Linux:sh
curl --proto' --tlsv1.2 -LsSf \
https://.com/Prayag887/chop-mcp/main/install.sh | sh
```
Windows PowerShell:
```powershell
irm https://raw.githubusercontentrayag887/chop-m/install.ps1 | iex安装程序检测操作系统和 CPU,下载相应的发布版本,验证其 SHA-256 校验和,并在用户拥有的目录它们不安装或调用 Cargo `CHOP_INSTALL_DIR`其他位置或 `CHOP 以安装特定版本。
动安装
从 [Git](https://github.com/Prayag887/chop-mcp 下载适用于您平台的存档:
| 平台 | 架构 | 发布目标 |
| --- | --- | --- |
| Linux | x86-64 | `x86_64-unknown-linux-musl` |
| Linux | ARM64 | `aarch64-unknown-linux-musl` |
| macOS | Intel | `x86_64-apple-darwin` |
| macOS | Apple silicon | `64-apple-darwin| Windows | x | `x86_64-pc-windows-msvc` |
| Windows | ARM64 | `a-pc-windows-msvc`压存档,然后将 `chop`(Windows 上为 `chop)放在您的 `PATH某个位置。Linux 构建l,不需要特定的系统已经安装 Rust 的开发人员可以从源代码构建:
```sh
cargo install --git https.com/Prayag887/chcp
```
发布二进制自包含的,不需要语言代码可在 macOS、 Windows 平台移植。
## Claude
安装二进制文件后,将其注册为用户级 stdio:
```sh
clcp add --scope user chop -- chop mcp
```
验证连接```sh
clcp list
```
要与中的每个人共享 MCP 配置存储库运行:
claude mcp add --scope project chop -- chop mgit add .mcp.json commit -m "配置 服务器"
```
Claude Code用户批准项目范围的。启用后,请询问 Claude:
```text
在当前使用 pack_context,聚焦architecture and module boundaries",并_tokens 为 60000其架构。
```
如果 ` 不在 `PATH` 中,请在注册命令中将第二个` 替换为可路径。
## Claude Desktop
Claude Desktop 支持本地二进制 MCP 服务器。将以下服务器添加到其 MCP,使用绝对可执行文件
```json
{
"mcpServers": {
": {
"command":/path/to/chop",
args": ["mcp"]
}
}
```
保存配置后重启 Claude Desktop。
## 客户端
启动 stdio
```sh
chop
```
示例客户端配置:
```json
{
"": {
" {
"command": " "args": ["mcp"]
}
}
}
```
服务器公开:
```text_context(
path,
?,
tokenizer?,
include?,
exclude?,
stats_only?,
max_tokens?,
focus allow_sensitive?,
allow?
)
```
`format接受 `claude`` 或 `plain`。
MCP 调用默认 ceiling 为 100,000 个令牌,并 200,000 个令限制。
代理应提供明的 `focus`,任务,以便进行最佳选择。
## 项目检测
检测包括 Rust、Go、Python、Django、Node.js、TypeScript、Next.js、Angular、Svelte、Kotlin、Kotlin Multiplatform、Compose Multiplatform、Flutter、Dart、Swift、Java、.NET、PHP 和 Ruby 项目。打包本身与语言无关,适用于任何 UTF-8 文本源文件。
## 令牌计数
GPT 计数使用二进制文件中嵌入的o200k_base词器。Anthropic 不发布离线 Claude器,因此 Claude 计数的本地估计。确切的 Claude 计数需要 Anthropic 的网络 API 和凭证,这将与` 的离线、零运行时依赖设计相冲突。
##
```sh
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test-features
cargo build