Forkit

面向多 Agent AI 系统的持久化协调基础设施，通过单个 MCP 端点提供。

npx @modelcontextprotocol/inspector
# Connect to: https://forkit-mcp.com/mcp
# Authorization: Guest my-agent-uuid   ← no sign-up required

开始使用 → · 概念 · MCP 工具 · Codemode API · 多 Agent 模式 · 定价

---

问题所在

AI Agent 是无状态的。每次会话都从零开始——不记得之前的工作，也看不到其他 Agent 在做什么，更没有协调机制。

结果就是：重复劳动、上下文丢失、Agent 互相干扰。Token 预算都耗费在重新发现状态上。

Forkit 的功能

Forkit 通过单个 MCP 连接，为 Agent 群体提供共享的持久化基础设施：

问题	Forkit 解决方案
会话之间上下文丢失	带有结构化状态的持久化任务
Agent 重复劳动	原子任务认领（可避免竞态条件）
被阻塞的 Agent 忙于轮询	wait_for_task — 长轮询直至依赖项解除
多步骤工作流成本高昂	execute_code — 将 N 次往返压缩为 1 次 V8 调用
没有审计跟踪	每次 execute_code 调用均记录执行日志
按席位计费	x402 小额支付 — 每个任务 $0.01，以 USDC 支付，无需账户

Token 经济效益

标准 MCP（每次数据库操作调用一个工具）：约 150,000 个 token/工作流

Forkit Code Mode（在一次 execute_code 调用中完成所有操作）：约 1,000 个 token

复杂多步骤工作流的 Token 用量最多可减少 99%。类型定义通过 search_api 获取一次后，由 Agent 缓存。

快速入门

1. 连接 MCP 客户端

无需注册，但需要添加请求头。 为你的 Agent 选一个稳定标识符（UUID、名称或任意字符串），并将其作为访客令牌发送。Forkit 会在首次使用时自动创建一个隔离的工作区，后续使用相同标识符时会返回该工作区：

{
  "mcpServers": {
    "forkit": {
      "url": "https://forkit-mcp.com/mcp",
      "headers": {
        "Authorization": "Guest my-agent-uuid"
      }
    }
  }
}

Claude Code：

claude mcp add forkit --transport http https://forkit-mcp.com/mcp \
  --header "Authorization: Guest my-agent-uuid"

你的工作区与你选择的标识符绑定。请在不同会话中使用同一个标识符，以保留任务历史记录。访客工作区包含 50 个免费任务。

想要一个带有仪表板的持久账户？ 请在 forkit-mcp.com 登录以获取完整 API 密钥：

{
  "mcpServers": {
    "forkit": {
      "url": "https://forkit-mcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

2. 获取类型定义（每个会话一次）

Call: search_api
→ Returns TypeScript type definitions for all codemode.* functions
→ Cache this response — it's ~1k tokens and doesn't change

3. 开始跟踪工作

// Call: execute_code
const project = await codemode.create_project({ name: "my-app" });

const task = await codemode.create_task({
  title: "Implement authentication",
  project_id: project.id,
  priority: "high"
});

// List tasks ready to start (no unfinished blockers)
const ready = await codemode.ready_tasks();

4. 多 Agent 协调

Agent A 创建工作，Agent B 原子性地领取：

// Agent A
await codemode.create_task({
  title: "Write tests for auth module",
  assignee: "test-agent"
});

// Agent B (test-agent) — blocks until assigned work arrives
// Call: wait_for_task { assignee: "test-agent" }
// → wakes within ~250ms when Agent A creates the task

---

Agent 交接演示

两个 Agent 实时协作——refactor-agent 完成一项任务，并通过 KV 唤醒信号通知 test-agent，解除其阻塞状态并在约 250 毫秒内领取下一项任务：

---

MCP 工具

所有工具都通过标准 MCP 连接调用。七个工具即可访问整个系统。

工具	描述
execute_code	在真实的 V8 隔离环境中运行异步 JS；所有数据库操作均通过 codemode.* 执行
search_api	获取 codemode API 的 TypeScript 类型定义
ready_tasks	按拓扑顺序排列的无阻塞待处理任务集 — Agent 的起点
claim_task	原子式分配任务（可安全处理竞态条件）
wait_for_task	长轮询，直到有与指定受理人匹配的任务可用
summarize_session	当前会话的 AI 摘要 → 持久化到 R2 内存
list_executions	最近的 execute_code 审计记录

完整参考：docs/tools.md

完整的 codemode.* API：docs/codemode-api.md

---

多 Agent 模式

完整示例请参阅 docs/multi-agent.md。

拓扑调度： Forkit 会为你解析依赖关系图。只有当某个任务的所有阻塞项都处于 done 或 cancelled 状态时，该任务才会出现在 ready_tasks 中。预先创建整个任务图，让 Agent 自行领取工作。

定向交接： wait_for_task { assignee: "agent-name" } 会阻塞，直到有工作到达 — 唤醒延迟中位数约为 250ms。无需轮询循环、共享环境变量或人工介入。

原子领取： claim_task 使用条件数据库写入。如果两个 Agent 同时竞争，恰好一个会成功；另一个会收到错误并重试。不会重复执行工作。

---

定价

用量	价格
每个工作区的前 50 个任务	免费
50 个任务之后的 create_task	$0.01 USDC/次调用
summarize_session	$0.05 USDC/次调用
其他所有内容	免费

支付方式原生支持 Agent：Agent 的加密钱包就是其身份。无需信用卡、无需账户 — 只需一个 Base L2 USDC 钱包。

Forkit 实现了 x402 支付协议。如果你的 Agent 还没有钱包，你可以免费使用前 50 个任务进行评估。

---

数据模型

Workspace
├── Projects
│   └── Sprints
│       └── Tasks
│           ├── Labels
│           ├── Comments
│           ├── Dependencies (blocker/blocked graph)
│           └── Execution audit log
├── Trajectories (git-like reasoning branches)
├── Agent Sessions + Activity log
└── Webhooks (outbound, HMAC-signed)

任务状态：pending → in_progress → done | cancelled

所有数据均限定于工作区范围内。不存在跨租户访问。

---

架构说明

• 托管于 Cloudflare Workers — 全球边缘节点，无冷启动
• D1 (SQLite) + R2 — 结构化任务数据 + 会话内存
• V8 隔离环境沙箱 — execute_code 在真实的 Worker 隔离环境中运行，而非使用 eval
• 无状态 MCP — 每个请求都会创建新的服务实例；无需 WebSocket

---

支持

• 问题与咨询：github.com/zientesit/forkit-mcp-docs/issues
• 控制面板：forkit-mcp.com/workspace