关于 StateDock
StateDock 是供团队及编码 Agent 共用的项目状态服务,将目标、决策和任务交接集中保存。此版本部署在自有 Cloudflare 账户中,Agent 可通过 MCP 读取上下文、领取就绪任务并记录交接。
主要功能
- 01集中保存项目目标与决策
- 02跨 Agent 记录任务交接
- 03部署于自有 Cloudflare 账户
- 04提供备份、恢复与升级指南
适用场景
- 01让编码 Agent 恢复项目上下文
- 02在不同工具间传递任务
- 03保存决策并记录进度
MCP 相关
Claude Code、Cursor 和 Codex 可通过 MCP 读取项目上下文、领取就绪任务并写回交接信息。该服务需部署于自有 Cloudflare 账户。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://statedock.dev/mcpclaude mcp add --transport http dev-statedock-statedock https://statedock.dev/mcp{"mcpServers":{"dev-statedock-statedock":{"type":"http","url":"https://statedock.dev/mcp"}}}在 Cursor 中打开{"servers":{"dev-statedock-statedock":{"type":"http","url":"https://statedock.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"dev-statedock-statedock":{"type":"http","url":"https://statedock.dev/mcp"}}}{"mcpServers":{"dev-statedock-statedock":{"serverUrl":"https://statedock.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
StateDock
为你和编码 Agent 提供共享项目记忆。
目标、决策和交接记录都集中在一处。Claude Code、Cursor 和 Codex 通过 MCP 读取上下文、接手已准备好的工作,并写回交接信息,让下一个 Agent 无需从零开始。
此仓库是 Cloudflare 可自托管版。你可以将其部署到自己的 Cloudflare 账户,并自行管理 Workers、D1、KV、R2、域名、邮件发送和备份。它与 StateDock Cloud 相互独立,不设 Cloud 订阅等级。如需通过一条命令在自己的电脑或 Linux 服务器上运行 StateDock,请改用 StateDock Local。
- 产品与共享功能指南:statedock.dev/doc
- 安装与部署:docs/self-hosting.md
- 备份、恢复与升级:docs/operations.md
- Agent 与 MCP 设置:docs/agent-setup.md
- 架构、验证与迁移:docs/architecture.md · docs/validation.md · docs/migrations.md
- 安全报告:SECURITY.md
编码工具插件
StateDock 独立的 MIT 插件仓库提供共享 Skills,用于通过 StateDock Remote MCP 保存计划、恢复任务上下文和记录进展。目前的软件包面向托管服务 https://statedock.dev/mcp;可自托管部署可将这些 Skills 用于自己的 MCP 设置,但已发布软件包的默认端点是托管服务。
- **Codex:**可从插件仓库的本地市场获取;安装说明见其 README。
- DeepSeek Harness:
@statedock/dsh-plugin已发布,适用于 Harness0.2.0-rc.2;请参阅官方社区展示。 - **ChatGPT 应用:**已提交给 OpenAI 审核;目前仍待批准。
- **Cursor:**正在准备市场提交材料;安装与审核状态尚未确认。
这些插件会记录并恢复项目状态,但不会执行任务代码或安排 Agent。插件代码采用 MIT 许可证;此可自托管服务仍仅采用 AGPL-3.0 许可证。
如需完整的本地安装,请使用上方的部署指南。该指南涵盖所需的 Cloudflare 资源、已验证的发件邮箱、公共 HTTPS 源站、密钥、迁移、部署、管理员审批和 Agent 访问。运维指南包含离线备份与恢复步骤。
开发检查
所需条件和仓库检查项列于 CONTRIBUTING.md。典型验证:
pnpm install --frozen-lockfile
pnpm test
pnpm typecheck
pnpm lint
pnpm format:check
pnpm selfhost:check
许可证
StateDock 采用 AGPL-3.0-only 许可证。依赖项保留各自的许可证;请参阅 THIRD_PARTY_NOTICES.md。该许可证不授予使用 StateDock 商标的权利,也不代表对第三方实例的官方背书。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。