Agent Mailbox Viewer Example

MCP代理邮件--共享邮箱快照

此存储库承载MCP代理邮件项目的静态导出。它包含一个经过清理的SQLite快照和一个自包含的查看器，这样队友就可以浏览线程、附件和元数据，而不需要直接访问数据库。

包含什么

• mailbox.sqlite3 --已清理邮箱数据库（保留代理名称，清除ack/read状态）。
• viewer/ --静态web查看器（Alpine.js+Tailwind），带有收件箱、线程浏览器、搜索和附件工具。
• manifest.json --机器可读元数据（项目范围、清理统计数据、托管提示、资产SRI哈希）。
• _headers --支持Netlify样式标头规则的主机的COOP/COEP标头。
• .nojekyll --禁用GitHub Pages的Jekyll处理 _headers 和 .wasm 资产原封不动。
• HOW_TO_DEPLOY.md --GitHub Pages、Cloudflare Pages、Netlify或通用主机的详细部署清单。

直播观众

这 viewer/index.html 应用程序在本地或部署到静态宿主时呈现导出的邮箱。如果此仓库是通过GitHub Pages发布的，则根 index.html 立即重定向到查看器。

生成此导出时检测到宿主信号：

• GitHub页面 --使用coi-serviceworker.js通过docs/或gh-pages分支部署包，以实现跨源隔离。 _（信号：Git远程：https://github.com/Dicklesworthstone/mcp_agent_mail.git)_

快速开始

1. 安装依赖项 （仅限第一次）：

   uv sync

1. 重建或更新导出 源项目：

   uv run python -m mcp_agent_mail.cli share update /path/to/this/repo

1. 本地预览:

   uv run python -m mcp_agent_mail.cli share preview .

该命令在以下位置为观众提供服务 http://127.0.0.1:9000/ 热重新加载。

1. 部署 使用GitHub Pages（内置于 share wizard)或手动遵循 HOW_TO_DEPLOY.md.

重新生成新快照

从MCP代理邮件源签出中，运行：

uv run python -m mcp_agent_mail.cli share export \
  --output /path/to/this/repo \
  --project 
 \
  --scrub-preset standard \
  --no-zip

这将用最新消息覆盖捆绑包（在清理仓库后），同时保留查看器资产。

验证完整性

• 已签名的捆绑包：如果 manifest.sig.json 如果存在，请通过以下方式进行验证：

  uv run python -m mcp_agent_mail.cli share verify . --public-key $(cat signing-*.pub)

• SRI哈希: manifest.json 记录观众资产的SHA256摘要；如果需要，静态主机可以固定哈希值。

故障排除

• GitHub页面显示404：确认页面设置为 main 树枝和根(/).向导呼叫 gh api repos/:owner/:repo/pages 自动；如果需要，请重新运行它。
• .wasm 作为文本/纯文本：确保 .nojekyll 存在并且 _headers 或者手动配置MIME类型。
• 查看器警告OPFS：主机必须发送COOP/COEP标头。GitHub Pages需要捆绑 coi-serviceworker.js 未注释（参见 HOW_TO_DEPLOY.md).

关于MCP代理邮件

MCP Agent Mail是用于多代理编码工作流的异步协调层。它捕获消息、附件和咨询文件保留，以便代理可以安全协作。静态导出使共享审计跟踪变得容易，而无需授予直接数据库访问权限。