Show HN:Mu——面向 Agent 的工具集
英文标题:🔶 Show HN: Mu – Tools for Agents
Mu 是一个 MCP 服务器和 Web 应用,旨在让 AI Agent 与人类通过同一套接口访问新闻、搜索、邮件、市场、天气、文件、日历等现实世界服务。项目提供覆盖 20 多个服务领域的工具,可通过 MCP、CLI、Web 应用以及 Discord 和 Telegram 调用,并支持按需限定向 Agent 暴露的工具范围。Mu 可接入 Claude、Atlas Cloud(DeepSeek)以及本地 Ollama 或 OpenAI 兼容端点,并为每位用户保留跨会话记忆。对开发者而言,它既可直接使用托管版本,也可通过 Docker 或源码自行部署,并能通过 JSON 配置扩展信息源、提示词和主页卡片。
38.8 KB
中文
面向 Agent 的工具
Mu 是一个面向 Agent 和人类的 MCP 服务器及 Web 应用。它通过 MCP 为 Agent 提供访问现实世界的能力,同时让人类能在 Web 应用中浏览或交互相同的内容。可访问新闻、网页搜索、邮件、市场、天气、视频、地点、图片、文件、日历、联系人等服务。
可在 micro.mu 上直接使用,或自行托管。
{
"mcpServers": {
"mu": {
"url": "https://micro.mu/mcp"
}
}
}
在 /token 创建个人访问令牌(Personal Access Token),并将其作为 Authorization: Bearer 发送。
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
这就是会列给你的 Agent 的工具。其他所有工具仍然可以调用。
浏览工具:micro.mu/tools —— 按服务分组列出每个工具,以及每次调用的成本。
协议细节请参阅 MCP 文档。
| 领域 | 工具 |
|---|---|
| Agent | agent · chat —— 向整套系统提问,让它组合生成答案 |
| 应用 | apps_build · apps_run · apps_edit —— 构建并运行小型 Web 工具 |
| 日历 | events_create · events_free · events_list —— 安排日程并查找空闲时间 |
| 联系人 | contacts_find · contacts_add · contacts_list —— 将姓名转换为地址 |
| 文件 | files_put · files_get · files_list · files_share —— 保存文件并获取 URL |
| 信仰 | islam_today · islam_prayer · islam_qibla · quran · hadith |
| 索引 | index_search —— 此实例为你保存的所有内容 |
| 图片 | images_generate · images_search |
| 邮件 | mail_inbox · mail_send · mail_address —— 具备 DKIM 的真实 SMTP 服务器,并为每个 Agent 提供一个地址 |
| 市场 | markets_list —— 股票、加密货币、期货、大宗商品、货币 |
| 新闻 | news_list · news_read · news_search —— RSS 聚合、完整文章 |
| 地点 | places_search · places_nearby · places_eta —— 兴趣点、地理编码、出行时间 |
| 存储 | db_create · db_get · db_list · db_update · db_delete —— 按调用方划分的记录 |
| 写作 | blog_* · social_* · stream_* —— 发布、阅读、讨论 |
| 钱包 | wallet_balance —— 额度,以及用于充值的 USDC 收款地址 |
| 天气 | weather_forecast —— 实时状况、预报、花粉信息 |
| 网页 | web_search · web_fetch —— 搜索网页,以干净文本读取页面 |
| 视频 | video_list · video_search —— 精选频道,无广告或推荐内容 |
提交 issue,说明你希望它实现什么功能。
该服务器包含一个带主页的 Web 应用。卡片以概览形式展示各项服务(头条、价格、天气、未读邮件),Agent 则内嵌在页面中,可针对你正在查看的内容执行操作。未登录访客可获得带实时数据的公开版本。
LLM——Claude、Atlas Cloud(DeepSeek),或本地 Ollama / OpenAI 兼容端点——会将这些服务作为工具调用、组合生成答案,并为每位用户保留跨会话记忆。
可使用用户名和密码、passkey(WebAuthn)或 Google 登录。对于 CLI,请在 /token 生成个人访问令牌。
每个工具都是一个 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 agent "what is the btc price?" # run the full agent
mu weather_forecast --lat 51.5 --lon -0.12
mu wallet # your balance
mu help # full tool 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
参阅 CLI 文档。
可通过 Discord 或 Telegram 与 Agent 对话——提问、查看市场和新闻,全部在聊天中完成。加入 Discord
Discord:/agent、/news、/markets、/weather、/mail、/social、/blog、/video、/search、/apps、/balance、/usage。Telegram:/agent、/ask、/news、/markets、/weather、/usage。
两者的设置方法均见 安装文档。
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
# 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
打开 http://localhost:8080,Mu 会引导你完成一次性设置:创建管理员账户并选择 AI 提供商(Claude、Atlas Cloud,或本地 Ollama / OpenAI 兼容端点)。完成后即可获得一个可用的 Agent。
对于终端设置,先以无界面方式配置提供商,再启动服务器:
mu setup # pick a provider, paste a key
mu --serve # first account you create becomes admin
或者手动设置全部内容:
export ADMIN=you@example.com # who's admin (else: first account)
export ATLAS_API_KEY=xxx # or ANTHROPIC_API_KEY, or OPENAI_BASE_URL
mu --serve
成为管理员后,其他所有密钥(YouTube、Brave 搜索、天气、邮件/DKIM、Google 登录等)都可在浏览器中的 /admin/env 配置。
参阅安装指南。
可通过编辑 JSON 文件自定义信息源、提示词和卡片:
service/news/feeds.json—— RSS 新闻源service/chat/prompts.json—— 聊天主题home/cards.json—— 主页卡片service/video/channels.json—— YouTube 频道service/places/locations.json—— 已保存的位置
所有选项请参阅环境变量。
完整文档位于 docs 文件夹。Agent 相关内容从 MCP 开始,代码相关内容参阅架构。在线工具目录位于 /tools。
AGPL-3.0 —— 可使用、修改、分发。如果你以服务形式运行修改后的版本,请共享源代码。
English / 原文
Tools for agents
Mu is an MCP server and web app for agents and humans. It provides access to the real world through MCP for the agents and let's humans browse or interact with same content in a web app. Access news, web search, mail, markets, weather, video, places, images, files, calendar, contacts and more.
Use it live at micro.mu, or self-host.
{
"mcpServers": {
"mu": {
"url": "https://micro.mu/mcp"
}
}
}
Create a Personal Access Token at /token and send it as Authorization: Bearer.
curl -X POST https://micro.mu/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Scope the connection to the services you need:
https://micro.mu/mcp?tools=news,web,mail
That's what gets listed to your agent. Everything else is still callable.
Browse the tools: micro.mu/tools — every tool, grouped by service, with what each call costs.
See MCP docs for the protocol details.
| Area | Tools |
|---|---|
| Agent | agent · chat — ask the whole thing a question and let it compose |
| Apps | apps_build · apps_run · apps_edit — build and run small web tools |
| Calendar | events_create · events_free · events_list — schedule, and find when you are free |
| Contacts | contacts_find · contacts_add · contacts_list — turn a name into an address |
| Files | files_put · files_get · files_list · files_share — keep a file, get a URL |
| Faith | islam_today · islam_prayer · islam_qibla · quran · hadith |
| Index | index_search — everything this instance holds for you |
| Images | images_generate · images_search |
mail_inbox · mail_send · mail_address — a real SMTP server with DKIM, and an address per agent |
|
| Markets | markets_list — stocks, crypto, futures, commodities, currencies |
| News | news_list · news_read · news_search — RSS aggregation, full articles |
| Places | places_search · places_nearby · places_eta — points of interest, geocoding, travel time |
| Storage | db_create · db_get · db_list · db_update · db_delete — per-caller records |
| Writing | blog_* · social_* · stream_* — publish, read, discuss |
| Wallet | wallet_balance — credits, and where to send USDC to top up |
| Weather | weather_forecast — conditions, forecast, pollen |
| Web | web_search · web_fetch — search the web, read a page as clean text |
| Video | video_list · video_search — curated channels, no ads or recommendations |
Open an issue and say what it should do.
The server includes a web app with a home screen. Cards render each service at a glance (headlines, prices, weather, unread mail) and the agent sits inline to act on what you're looking at. Logged-out visitors get a public version with live data.
An LLM — Claude, Atlas Cloud (DeepSeek), or a local Ollama / OpenAI-compatible endpoint — calls the services as tools, composes answers, and keeps per-user memory across sessions.
Sign in with a username and password, a passkey (WebAuthn), or Google. For the CLI, generate a Personal Access Token at /token.
Every tool is a mu subcommand. The same binary runs the server (mu --serve) and the CLI.
mu news_list # latest headlines
mu news_search "ai safety" # search news
mu web_search "claude code" # search the web
mu agent "what is the btc price?" # run the full agent
mu weather_forecast --lat 51.5 --lon -0.12
mu wallet # your balance
mu help # full tool list
The CLI is registry-driven — a tool added to the server automatically becomes a CLI command.
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
See CLI docs.
Talk to the agent from Discord or Telegram — questions, markets, news, all from chat. Join the Discord
Discord: /agent, /news, /markets, /weather, /mail, /social, /blog, /video, /search, /apps, /balance, /usage. Telegram: /agent, /ask, /news, /markets, /weather, /usage.
Setup for both is in Installation.
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
# 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
Open http://localhost:8080 and Mu walks you through a one-time setup: create your admin account and pick an AI provider (Claude, Atlas Cloud, or a local Ollama / OpenAI-compatible endpoint). That's enough to have a working agent.
For terminal setup. Configure the provider headless, then start the server:
mu setup # pick a provider, paste a key
mu --serve # first account you create becomes admin
Or set everything by hand:
export ADMIN=you@example.com # who's admin (else: first account)
export ATLAS_API_KEY=xxx # or ANTHROPIC_API_KEY, or OPENAI_BASE_URL
mu --serve
Once you're admin, every other key (YouTube, Brave search, weather, mail/DKIM, Google sign-in…) is configurable from /admin/env in the browser.
See Installation guide.
Customise feeds, prompts and cards by editing JSON files:
service/news/feeds.json— RSS news feedsservice/chat/prompts.json— chat topicshome/cards.json— home screen cardsservice/video/channels.json— YouTube channelsservice/places/locations.json— saved locations
See Environment Variables for all options.
Full docs in the docs folder. Start with MCP for agents, Architecture for the code. The live tool catalogue is at /tools.
AGPL-3.0 — use, modify, distribute. If you run a modified version as a service, share the source.