mu

Личный агент.

Обзор

Агент с адресом. Общайтесь с ним в браузере или пишите ему по электронной почте, и он получает доступ к более чем 100 инструментам: новости, почта, поиск, погода, рынки, видео, места, файлы, контакты, календарь, документы. Работа в процессе.

Клиенты

Протоколы

SMTP на входе, IMAP на выходе, HTTP для приложения, MCP для агентов, x402 для платежей.

Возможно, протоколы — это выигрышная стратегия?

Инструменты

Откройте issue, чтобы запросить инструмент.

Установка

curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
mu --serve

Откройте http://localhost:8080. Первый созданный вами аккаунт становится администратором.

Работает без какой-либо настройки. Лишь некоторым функциям нужен API-ключ.

Выполните настройку в CLI

mu setup        # pick an AI provider, paste a key
mu --serve

Всё остальное — почта и DKIM, вход через Google, Stripe, x402 — необязательно и настраивается в /admin/config, когда вы вошли как администратор.

Другие способы запуска:

# Docker
git clone https://github.com/micro/mu && cd mu
docker compose up

# From source
git clone https://github.com/micro/mu
cd mu && go install
mu --serve

См. руководство по установке.

Подключение через MCP

Cursor и клиенты с файлом конфигурации. Создайте токен на /token:

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

Claude Desktop. Настройки → Коннекторы → Добавить пользовательский коннектор и вставьте https://micro.mu/mcp. Он регистрируется сам, открывает браузер и просит вас войти — токен не нужен. Вставить URL в claude_desktop_config.json не получится: этот файл принимает только локальные серверы командной строки.

Любой другой клиент. Это JSON-RPC поверх HTTP POST:

curl -X POST https://micro.mu/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ограничьте подключение нужными вам сервисами:

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

Полный список инструментов см. на micro.mu/tools.

Приложение

Сервер включает веб-приложение. На главном экране каждый сервис виден с одного взгляда — заголовки новостей, цены, погода, непрочитанная почта — а агент встроен прямо туда, чтобы действовать в контексте того, на что вы смотрите. Приложения выполняются в песочнице, в непрозрачном origin, и обращаются к платформе через фиксированный набор операций, а не через вашу сессию.

Вход по имени пользователя и паролю, ключу доступа (passkey, WebAuthn) или через Google.

CLI

Каждый инструмент — это подкоманда mu. Один и тот же бинарник запускает и сервер (mu --serve), и CLI.

mu news list                            # latest headlines
mu news search "ai safety"              # search news
mu web search "claude code"             # search the web
mu markets list --category stocks       # live prices
mu weather forecast --lat 51.5 --lon -0.12
mu docs list --collection notes         # your own documents
mu x402                                 # paying per call: config, and your key
mu help                                 # full tool list

Каждый инструмент из таблицы выше — это команда: сначала сервис, затем метод. Работает и форма с подчёркиванием, так что mu news list и mu news_list — один и тот же вызов.

CLI управляется реестром — инструмент, добавленный на сервер, автоматически становится командой CLI.

mu login                  # opens /token in your browser, paste the PAT back
mu config set token xxx   # or set it directly
export MU_TOKEN=xxx       # or use the environment

Запустите mu --help, чтобы получить список — он читает тот же каталог, что и агент.

Это вызовы инструментов, а не запуски агента: одна команда, один инструмент, без участия модели. mu agent среди них нет — это режим, описанный ниже, и ему нужны ключ модели и кошелёк, а не токен.

Почта

Сервер является MTA: он слушает SMTP, доставляет исходящую почту на MX получателя с подписью DKIM и фильтрует входящее. Учётная запись — это адрес.

asim@micro.mu             your address; mail here reaches your agent
asim+research@micro.mu    your agent named "research"
agent@micro.mu            the instance's shared agent

Часть после + определяет, какой агент будет отвечать. Ответы выстраиваются в цепочку — In-Reply-To и References проставляются согласно цепочке — и всё пришедшее доступно для чтения в /inbox.

От незнакомцев ничего не приходит. Входящая почта отклоняется с ошибкой 550, если только это не ответ на отправленное нами, мы ранее не писали на этот адрес, домен отправителя не внесён в белый список или отправитель не верифицирован в учётной записи здесь. Политика находится в начале файла service/mail/inbound_filter.go.

IMAP и SMTP submission означают, что почтовый ящик открывается в Thunderbird, Mail.app или на телефоне, и оттуда же можно отвечать. Имя пользователя — имя вашей учётной записи, пароль — токен доступа из /token. Порты, TLS и рабочий конфиг nginx приведены в разделе Установка; examples/imap-client — работающий клиент.

Для самостоятельного хостинга нужны MAIL_DOMAIN, MX-запись и входящий SMTP. См. Установку.

Агент (со своей моделью)

mu agent — это бинарник в роли клиента экземпляра, а не средство обращения к тому, в который вы вошли. Он хранит ваш ключ модели и приватный ключ, читает каталог инструментов у работающего экземпляра и платит за каждый вызов через x402 — без учётной записи на этом экземпляре и без регистрации.

Ключевое различие: mu news list использует вашу учётную запись на экземпляре, а mu agent — ваш кошелёк на чужом. Их объединяет лишь бинарник — и больше ничего.

# 1. A model. The tools are rented; the thinking is yours.
export ANTHROPIC_API_KEY=sk-ant-...     # or OPENROUTER_API_KEY
                                        # or OPENAI_BASE_URL for Ollama etc.

# 2. A wallet. Created for you on first run, or make it yourself:
mu x402 key new                         # prints an address; send USDC on Base
                                        # to it. No ETH — you never pay gas.

# 3. Ask.
mu agent                                # a conversation
mu agent "what happened in markets today?"

model: anthropic/claude-sonnet-4-6
112 tools from https://micro.mu
wallet: 0x4160a863… (1.27 USDC)

> what are the top news headlines today?
· news_list
…
> of those, which matters most for markets?
… answered with no tool call, and no charge

Чтение каталога бесплатно, поэтому всё работает, даже когда кошелёк пуст — средства нужны только для платных инструментов. Потраченное за запуск считывается из блокчейна по его завершении, а не суммируется из того, что агент полагает авторизованным.

--server указывает ему на любой x402-экземпляр; подойдёт и имя из X402_SERVERS. --seed использует другой ключ.

Кредиты и платежи

Пользователь пополняет счёт картой и расходует единый кредитный баланс. Один кредит — это 1 пенс.

Кредит списывается, когда вызов обходится этому экземпляру в деньги: вызов модели или сторонний сервис, тарифицируемый за каждый запрос. Всё остальное стоит 0 — сам агент, ваш почтовый ящик, ваши файлы, чтение и отправка почты из почтового клиента. Цены заданы в quota.json — единственном месте, где они устанавливаются.

Исключение — почта, адресованная за пределы экземпляра. Она тарифицируется и ограничена дневным лимитом, причём не потому, что её отправка чего-то стоит: то, что цикл там расходует, — это репутация отправляющего домена, и никакой баланс этого не восстановит. Цена останавливает того, кому приходится платить; лимит — вот что останавливает цикл.

Агент может платить в USDC через x402 и при этом никогда не регистрироваться. Платный вызов без учётных данных отвечает 402 Payment Required, указывая цену и куда её отправить. Платёж и есть идентификация.

Чтобы написать платящего агента, см. examples/x402-agent — автономный модуль, который ничего из этого не импортирует. Он использует SDK x402 Foundation, поэтому тот же файл платит

любой сервер x402.

Чтобы увидеть его работу, mu также является собственным клиентом. Поместите ключ пополненного кошелька Base в ~/.mu/keys/wallet.seed:

mu x402 call web_search query="x402"   # 402 → signs → pays → returns the result

Самостоятельный хостинг без Stripe и без x402, и ничего не тарифицируется: каждый инструмент бесплатен.

Конфигурация

Настройте ленты, подсказки и карточки, отредактировав JSON-файлы:

• service/news/feeds.json — RSS-ленты новостей
• service/chat/prompts.json — темы чата
• home/cards.json — карточки домашнего экрана
• service/video/channels.json — каналы YouTube
• service/places/locations.json — сохранённые местоположения

См. Установка для всех настроек, которые читает код.

Лицензия

AGPL 3.0