micro/mu · 上手攻略

• 仓库：micro/mu
• 链接：https://github.com/micro/mu
• 分类：agent-platform · MCP · productivity-tools
• 作者：Jay
• 更新：2026-08-27

这是什么

mu（读作 /mjuː/）是一个面向人类、AI 代理和服务的通用协议网络。它用一套协议栈（SMTP 收件、IMAP 读件、HTTP 服务、MCP 对接 Agent、XMPP 聊天、x402 支付）把邮件、工具、日历、文件、搜索等 100+ 项能力统一起来，让一个 AI Agent 可以像真人一样拥有自己的邮箱、联系人、日历和文件系统。

它的核心哲学是「地址即身份」：你的 you@your.domain 就是一个真实邮箱，任何人（包括其他 Agent）往这个地址发邮件，就能触达你绑定的 Agent，Agent 用 you+research@ 的格式可以把邮件路由给特定的子 Agent。

官方在 https://micro.mu 运行了一个托管实例，开箱即用；也可以完全自托管。

解决什么问题

如果你需要让 AI Agent 真正操控真实世界（发邮件、查日历、管文件、搜网页、查股价），传统方案是每个 Agent 各自对接一套 OAuth/API，成本高且不通用。

mu 的解法：Agent 用 MCP（Model Context Protocol） 协议接入一个统一的工具平台，100+ 工具一次接入，全平台通用。你可以在任何支持 MCP 的 Agent（Claude Desktop、Cursor 等）里配置 mu，Agent 就能调用邮件、天气、新闻、航班、地图、钱包等所有工具，无需逐一对接每个服务的 API。

对于个人用户，mu ask "what's in my inbox?" 就是在跟你的个人 Agent 对话，邮件、日历、文件都在同一个上下文里。

快速安装

方式一：一键脚本（推荐尝鲜）

curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
mu --serve
# 打开 http://localhost:8080，创建第一个账号（默认成为 admin）

方式二：Docker（推荐生产）

git clone https://github.com/micro/mu && cd mu
docker compose up
# 同样打开 http://localhost:8080

方式三：从源码编译

git clone https://github.com/micro/mu
cd mu && go install   # 需要 Go 1.21+
mu --serve

安装后需要配置 AI 模型（至少选一个）：

mu setup        # 交互式引导：选 AI provider、粘贴 API key
mu --serve

必填 Key：

用途	环境变量
AI 模型（任选）	ANTHROPIC_API_KEY 或 OPENROUTER_API_KEY 或 OPENAI_BASE_URL（本地 Ollama 免费）
网页搜索	BRAVE_API_KEY（有免费额度）
YouTube 视频	YOUTUBE_API_KEY（免费配额）

其他（邮件、Google 登录、Stripe 支付等）为可选项。

核心用法

CLI 工具调用（最简单入口）

mu 二进制文件同时是客户端和服务器。每条工具对应一个子命令：

# 最新新闻
mu news list
mu news search "AI safety"

# 网页搜索
mu web search "最新大模型发布"

# 查股价
mu markets list --category stocks
mu markets convert 100 USD to BTC

# 查天气（伦敦）
mu weather forecast --lat 51.5 --lon -0.12

# 你的文档
mu docs list --collection notes
mu docs write --title "今日笔记" --body "内容"

# 查日历
mu events list
mu events create --title "会议" --start "2026-08-28T10:00"

# 发邮件
mu mail send --to "friend@example.com" --subject "Hello" --body "正文"

# 给 Agent 发任务（本地运行 Agent，把任务甩给远程实例）
mu ask "summarize my inbox"
mu ask --agent research "anything new this week?"

# 查航班（实时坐标）
mu flights track --flight "BA123"

工具列表注册驱动：新工具加到服务器，CLI 命令自动可用。

MCP 接入（连接 AI 助手）

Claude Desktop（推荐）： 1. Settings → Connectors → Add custom connector 2. 填入 https://micro.mu/mcp 3. 浏览器会自动打开登录，无需 token 配置

Cursor / 其他 MCP 客户端： 在客户端配置文件里加：

{
  "mcpServers": {
    "mu": {
      "url": "https://micro.mu/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MU_TOKEN}"
      }
    }
  }
}

Token 在 https://micro.mu/token 生成。

限定工具范围（减少不必要的权限）：

https://micro.mu/mcp?tools=news,web,mail,weather

自托管指向官方实例（测试用）

默认情况下，mu CLI 指向 https://micro.mu（官方托管实例）：

mu login https://your.host   # 指向你自己的实例，保存地址+token
mu config get               # 查看当前指向的实例

典型适用场景

1. 个人 AI 助手：给自己建一个 me@domain.com，在 Claude/Cursor 里用 MCP 接入，随时查邮件、日历、文件、新闻，不需要分别对接每个服务。
2. 多 Agent 协作：给不同子任务建不同的 + 子地址（you+research@、you+coding@），同一个邮箱账号下跑多个 Agent，各司其职。
3. 无账号支付（x402）：调用付费工具时返回 402 状态码 + USDC 价格，付款后自动放行，Agent 不需要注册账号。
4. 开发者工具平台：在 Docker 里跑 mu 实例，给团队成员开账户，统一提供 100+ 工具能力。
5. 实时数据查询：航班实时坐标、股市、天气预报、公交实时到站——这些公开数据工具无需任何 API key。

坑与注意

• 工具按次计费：部分工具（如 Shell 运行、AI 模型调用）是按次收费的，quota.json 是价格表，可以替换为自定义计费规则。查看当前配额：mu x402
• MCP token 生成：Claude Desktop 用 UI 方式添加 Connector 最可靠，直接改 claude_desktop_config.json 填 URL 对 MCP server 不生效。
• 本地 Ollama 免付费：在 OPENAI_BASE_URL=http://localhost:11434/v1 指向本地 Ollama，AI 模型调用免费。
• Docker 需预装：自托管的 Shell 工具需要在实例上安装 Docker，否则 Shell 命令不可用。
• 英国数据为主：天气、地图（Ordnance Survey）、公交（伦敦 TfL + DfT）、食品卫生（英国 FSA）等部分工具是英国数据，对其他地区覆盖有限。
• x402 支付在 Base 链：付款工具使用 USDC on Base，需要钱包里有少量 USDC。

与同类对比

能力	mu	LangChain Agents	OpenAI Assistants	n8n
MCP 原生支持	✅	❌	❌	❌
SMTP 邮件即 Agent 地址	✅	❌	❌	❌
100+ 内置工具	✅（统一平台）	❌（需自行组装）	有限	300+（社区集成）
自托管	✅	✅	❌（仅托管）	✅
x402 原生支付	✅	❌	❌	❌
复杂度	中	高	低	高

mu 的差异化在于协议层整合（SMTP/IMAP/MCP/x402 一套跑）而非工具数量。它的定位更像"个人 AI 操作系统"，而非单纯的 Agent 框架。

一句话推荐结论

如果你想让 AI Agent 真正拥有一个「真实身份邮箱 + 100 项工具能力」，mu 是目前 MCP 生态里最干净的一站式方案——开箱即用，自托管灵活，值得上手体验。

---

⚠️ 注：本文档基于 GitHub README（2026-08-27 fetch）撰写。mu 仍在活跃开发，部分工具名称和行为可能随版本变化。建议以 mu help 输出和 docs/INSTALL.md 为准。