内容
# gcf-claude-plugin
Claude Code 插件，适用于 [GCF 代理](https://github.com/blackwell-systems/gcf-proxy)。可降低 71% 的 MCP 工具调用令牌成本。
## 安装
```bash
/plugin install blackwell-systems/gcf-claude-plugin
```
## 功能介绍
每次 MCP 工具调用都返回 JSON 数据。该插件使用 [GCF 代理](https://github.com/blackwell-systems/gcf-proxy) 包装您的 MCP 服务器，在数据到达模型之前，将 JSON 响应重新编码为 GCF 格式。
**节省成本：**
| 指标 | 值 |
|--------|-------|
| 相比 JSON 减少令牌 | **71%** |
| 相比 TOON 减少令牌 | **25%** |
| 会话去重（热会话） | **最高 92%** |
| 理解准确率 | **100%**（超过 1,700 次 LLM 评估） |
相同的数据，更少的令牌。每次工具调用、每次会话的成本都更低。
## 技能
| 技能 | 描述 |
|-------|-------------|
| `/gcf-proxy:setup <服务器>` | 用 gcf-proxy 包装任何现有的 MCP 服务器。保留原始配置，以便轻松恢复。 |
| `/gcf-proxy:stats` | 显示当前会话的令牌节省情况。 |
## 快速入门
安装后，包装任何 MCP 服务器：
```
/gcf-proxy:setup github
```
这会修改您的 MCP 配置，将 `github` 服务器的请求路由到 gcf-proxy。原始配置会被保留（被禁用，并带有 `-raw` 后缀），以便您可以随时恢复。
## 节省成本的原理
1. **首次调用（71% 节省）：** GCF 以 71% 更少的令牌编码相同的数据。模型以 100% 的理解准确率（无需预热）读取 GCF 数据。
2. **后续调用（最高 92%）：** GCF 会话去重功能检测同一会话中工具调用的重复结构。只传输变化的部分。在会话的第 5 次调用中，令牌使用量降至原始 JSON 成本的 8%。
3. **无需代码更改：** gcf-proxy 包装任何 MCP 服务器。服务器仍然输出 JSON；代理在数据到达模型之前重新编码它。
## 手动设置
如果您更喜欢手动配置，请编辑您的 `.mcp.json`：
```json
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["-y", "@blackwell-systems/gcf-proxy@latest", "npx", "-y", "your-mcp-server"]
}
}
}
```
## 成本示例
每天运行 1,000 次查询的团队，使用 Claude Sonnet 4.6（每百万令牌输入 3 美元）：
| 格式 | 每月成本 | 年度成本 |
|--------|-------------|-------------|
| JSON | 7,259 美元 | 87,103 美元 |
| GCF | 2,129 美元 | 25,543 美元 |
| **节省** | **每月 5,130 美元** | **每年 61,560 美元** |
[使用您自己的数字](https://gcformat.com/calculator) 尝试成本计算器。
## 要求
- Node.js 18+
- 支持插件的 Claude Code
## 链接
- [GCF 规范](https://gcformat.com)
- [GCF 代理](https://github.com/blackwell-systems/gcf-proxy)
- [基准测试](https://gcformat.com/guide/benchmarks.html)（超过 1,700 次 LLM 评估，100% 理解准确率）
- [成本计算器](https://gcformat.com/calculator)
## 许可证
MIT
