mcp_agent_mail

环境要求

• 类 Unix 环境（含 curl 与 bash），可运行官方安装脚本
• Python 3.14（一键脚本可用 uv 自动安装）
• uv 包管理器（安装脚本会检测并自动安装，过旧需先 uv self update）
• jq（安装脚本会自动安装，用于安全合并配置）

安装与启动步骤

1. 1一键安装并启动

   运行官方安装脚本，自动装 uv/jq、创建 Python 3.14 虚拟环境、集成已装代理工具，并在 8765 端口启动 MCP 服务器。

   curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail/main/scripts/install.sh?$(date +%s)" | bash -s -- --yes

   复制

2. 2手动创建环境

   不想用一键脚本时，用 uv 安装 Python 3.14、创建并激活虚拟环境并同步依赖；uv 版本过旧先执行 uv self update。

   uv python install 3.14
   uv venv -p 3.14
   source .venv/bin/activate
   uv sync

   复制

3. 3检测并集成代理

   自动检测本机已安装的编码代理工具，将它们接入 mcp_agent_mail，并启动 8765 端口的 MCP 服务器。

   scripts/automatically_detect_all_installed_coding_agents_and_install_mcp_agent_mail_in_all.sh

   复制

4. 4重新启动服务器

   后续用同一 token 再次启动 MCP 服务器；该脚本由安装脚本生成在 scripts/ 目录下。

   scripts/run_server_with_token.sh

   复制

5. 5查看当前端口

   输出当前生效的端口配置，用来确认改动是否已经生效。

   uv run python -m mcp_agent_mail.cli config show-port

   复制

6. 6修改监听端口

   安装完成后可把 HTTP 端口从默认 8765 改成别的值，示例改为 9000。

   uv run python -m mcp_agent_mail.cli config set-port 9000

   复制

7. 7诊断与修复

   先用 --dry-run 预览将要执行的修复，确认无误后再执行实际修复，实际修复会提示数据变更。

   uv run python -m mcp_agent_mail.cli doctor repair --dry-run
   uv run python -m mcp_agent_mail.cli doctor repair

   复制

关键配置

如何确认成功

终端显示 MCP HTTP 服务器已在 8765 端口启动，并打印出经过掩码的 bearer token。

常见问题

注意事项

• README 开头声明本 Python 版已被 mcp_agent_mail_rust 取代且不再维护，新部署建议用 Rust 版。
• 一键安装脚本会安装 Beads Rust（br）并创建指向 br 的 bd 别名，会替换已有的 bd（Go）安装。
• 安装脚本会在 .zshrc 或 .bashrc 中添加 am 别名，新终端直接输入 am 即可快速启动服务器。