DreamAgent

---

DreamAgent 的功能

DreamAgent 是一个 AI 应用构建平台：你描述 想要什么，它的 Agent 就会编写代码、运行测试、重新构建、重新部署到 生产环境并提交到 git — 全自动。这个 MCP 服务将这些能力开放给你的 AI 聊天，因此：

你：“创建一个名为 WeatherBot 的 Telegram 机器人 — token 123:ABC — 当我发送城市名称时，它会回复天气。”

**ChatGPT：**创建 → 轮询 → “WeatherBot 已上线。”

你：“添加一个用于 5 日天气预报的 /forecast 命令。”

**ChatGPT：**发送编辑指令 → Agent 编写代码、测试、重新部署 → 完成。

工具

工具	功能
dreamagent_list_projects	列出你的项目（id、类型、状态、域名）
dreamagent_create_project	创建网站 / Telegram 机器人 / Discord 机器人 / Agent 项目
dreamagent_get_project_status	轮询构建状态，直到变为 ready / failed
dreamagent_chat	向项目的 AI Agent 发送构建 / 编辑 / 调试指令
dreamagent_get_chat_status	轮询编辑运行状态（增量输出）
dreamagent_get_edit_progress	按项目查看编辑进度 — 无需会话密钥
dreamagent_list_sessions	列出每个项目的对话线程
dreamagent_create_session	开启一个新的主题线程
dreamagent_cancel_chat	取消正在运行的编辑
dreamagent_release_project_lock	最后的解锁手段（请先确认）
dreamagent_list_files	列出项目文件树
dreamagent_read_file	读取一个项目源文件
dreamagent_edit_file	对现有文件进行定向查找 → 替换编辑（编辑时优先使用）
dreamagent_write_file	创建 / 覆盖文件（需确认，适用于新文件和完整重写）
dreamagent_get_file_diff	查看相对于上次提交的待处理更改
dreamagent_delete_file	删除文件（需确认）
dreamagent_commit_push	将所有待处理更改作为一个版本提交并推送（或重试失败的提交）
dreamagent_list_commits	版本历史记录（哈希、消息、状态）— 可在控制面板中还原
dreamagent_build_publish	重新构建并发布项目（需确认）
dreamagent_design_mode	上传设计图片 → Agent 据此重新设计 UI
dreamagent_screenshot_website	截取任意公开页面的屏幕截图（返回图片 + URL）
dreamagent_list_superpowers	项目的 AI 工具目录（歌曲、图像、视频工具）
dreamagent_list_project_env	项目环境变量名称（值已遮罩，密钥已隐藏）
dreamagent_list_global_integrations	查看账户所有者已连接的服务提供商

长时间运行的操作采用提交后轮询 — 创建 → 轮询状态，编辑 → 轮询 进度。每次文件更改都会自动提交并推送，因此每次编辑都会记入会话历史和版本历史（可还原）。Agent 会自行处理代码、测试、重新构建、重新部署和 git 提交；提示词 只需描述更改内容。

连接 — ChatGPT

**使用官方应用（推荐）：**在 ChatGPT 应用目录中找到 DreamAgent → 连接 → 使用你的 DreamAgent 账户登录（邮箱或 Google）。

作为自定义连接器：

1. 在 DreamAgent 中 → 设置 → 连接到 ChatGPT → 创建密钥 → 复制 完整 URL（其中包含你的密钥）
2. ChatGPT → 设置 → 应用和连接器 → 高级 → 添加自定义连接器
3. 将 URL 粘贴为 MCP 服务 URL，选择 OAuth（或选择无需 身份验证 — 密钥包含在 URL 中），然后保存
4. 提问：“显示我的 DreamAgent 项目”

连接 — Claude

Claude → Settings → Connectors → Add custom connector：

• Name： DreamAgent
• Remote MCP server URL： https://mcp.dreamagent.cloud/mcp
• OAuth： 留空 — Claude 会自动发现

点击 Connect，使用 DreamAgent 登录即可。

连接 — 任意 MCP 客户端

{
  "mcpServers": {
    "dreamagent": {
      "type": "streamable_http",
      "url": "https://mcp.dreamagent.cloud/mcp"
    }
  }
}

身份验证采用 OAuth 2.1（授权码 + PKCE、RFC 7591 动态注册） — 或将 DreamAgent API 密钥作为 Authorization: Bearer da_... / ?key=da_... 传递。

提示词示例

• “显示我的 DreamAgent 项目”
• “创建一个名为 PriceBot 的 Discord 机器人 — 令牌 <from Discord dev portal> — 它通过 /price 和 /top 命令显示加密货币价格”
• “我的网站构建完成了吗？”
• “我的加密货币机器人停止回复了 — 出了什么问题？”（编辑操作会先由 Agent 读取项目日志）
• “为我的文档网站添加深色模式切换开关”
• “回滚昨天对仪表板的更改” （通过聊天）
• “我还剩多少 AI 积分？”

工作原理

ChatGPT / Claude / Glama
   │  MCP (streamable HTTP) + OAuth 2.1
   ▼
mcp.dreamagent.cloud ── this server (FastMCP)
   │  per-request Bearer = the user's own DreamAgent API key
   ▼
api.dreamagent.cloud ── DreamAgent platform
   └── agent writes code → tests → rebuild → deploy → git commit

每个请求都以已连接用户的身份运行 — DreamAgent 的所有权检查、 套餐限制和 AI 积分计费均与仪表板中的规则完全一致。

安全与隐私

• 你的密钥属于你的账户。 OAuth 会在连接时签发可撤销的 DreamAgent API 密钥 （da_...）— 可随时在 Settings → Connect to ChatGPT 中查看和撤销。撤销后，该客户端会立即断开连接； 其他客户端仍可正常使用。
• 正确实施 OAuth。 授权码 + 必须使用 PKCE (S256)、 一次性 120 秒授权码、重定向 URI 允许列表（按 RFC 8252 支持环回地址）、 登录速率限制，以及在提交时验证密钥。客户端注册信息会在重启后保留。
• 聊天中不含机密。 Telegram/Discord 机器人令牌通过 HTTPS 发送至 DreamAgent，并作为项目环境变量存储在服务器端 — 与仪表板的创建对话框相同。MCP 服务绝不会记录凭据。
• 本服务不会存储令牌 — 它会在每个请求中转发调用方自己的 Bearer 令牌，且不使用数据库。

隐私：dreamagent.cloud/privacy · 条款：dreamagent.cloud/terms

截图

Coming soon — a GIF of "Create a Telegram bot" end-to-end from ChatGPT.

自托管 / 开发

托管端点（mcp.dreamagent.cloud）是最简单的连接方式。 如需运行自己的实例：

git clone https://github.com/nivethaug/dreamagent-mcp-server
cd dreamagent-mcp-server
pip install -r requirements.txt
cp .env.example .env          # optional: your account for local stdio mode
python server.py              # stdio
python server.py --http --port 8800   # remote MCP (put behind HTTPS)

**生产主机上的加固措施：**该服务通过 run-mcp.sh 在 pm2 下运行，并加入专用 cgroup dreamagent-mcp-egress。 主机防火墙规则（/usr/local/sbin/mcp-egress-rules.sh，由 mcp-egress-block.service systemd 单元应用）会阻止该 cgroup 向所有内部网段发起新连接（环回/RFC1918/链路本地/CGNAT/多播， IPv4 + IPv6），同时允许 DNS 和公共网络流量 — 因此截图永远无法访问内部服务，即使通过重定向或子资源也不行。

系统依赖 — Chromium：dreamagent_screenshot_website 工具使用系统 Chromium/Chrome 二进制文件渲染页面（按顺序检查： /usr/bin/chromium、/usr/bin/chromium-browser、/usr/bin/google-chrome， 然后检查 PATH）。pip 不会安装它 — 在 Debian/Ubuntu 上：

apt-get install -y chromium          # or chromium-browser / google-chrome

如果没有它，其他所有工具仍可正常工作；截图工具会返回清晰的 “no headless chromium binary”错误。

每个请求按以下优先顺序采用三种身份验证模式：

1. Authorization: Bearer da_... 标头（OAuth 客户端 / API 客户端）
2. ?key=da_... URL 参数（NoAuth 自定义连接器）
3. DREAMAGENT_EMAIL / DREAMAGENT_PASSWORD 环境变量（个人自托管）

目录结构：server.py（工具）· oauth.py（OAuth 2.1 提供方：/register、 /authorize、/token、/.well-known/*）· dreamagent_client.py（API 客户端）· auth.py（登录模式）· plugin/（Codex 插件包）。

OAuth 客户端注册信息保存在 oauth_clients.json 中；通过 TRUSTED_OAUTH_REDIRECTS 扩展可信网关回调地址。

Links

• DreamAgent — dreamagent.cloud
• Documentation — dreamagent.cloud/documentation
• Help & Support — dreamagent.cloud/help
• Support — [email protected]

License

MIT