【技术文档摘要】

mu-mcp: 邮件索引器 mu 的 MCP 服务器

一个用于查询本地 mu 邮件索引的模型上下文协议（MCP）服务器。此服务器支持从 Claude Desktop 和其他 MCP 客户端进行快速、结构化的邮件搜索。

<img src="assets/claude-screenshot.png" width="500"/>

特性

• Stdio MCP 服务器，便于集成
• 三种工具：查询、查看邮件和打开附件（使用默认的操作系统查看器）
• 使用 mu 索引进行快速、灵活的邮件搜索
• 适用于 Claude Desktop：简单安装和配置
• 基于Python、uv 和 MCP SDK

安装

克隆此仓库并安装依赖项：

git clone https://github.com/danielfleischer/mu-mcp.git
cd mu-mcp
uv venv
uv pip install .

使用

运行 MCP 服务器

使用 uv：

uv run --directory . mcp run mu_mcp/mu_mcp.py

或者直接使用 Python：

python mu_mcp/mu_mcp.py

Claude Desktop 集成

在你的 claude_desktop_config.json 中添加：

"mcpServers": {
  "mu_mcp": {
    "command": "uv",
    "args": [
      "run",
      "--directory",
      "PROJECT_PATH",
      "mcp",
      "run",
      "mu_mcp/mu_mcp.py"
    ]
  }
}

将 PROJECT_PATH 替换为你克隆的仓库路径。

查询

让 Claude 找到邮件，例如："找到带有 PDF 附件且在去年四月发送的邮件，并打开 PDF"，"显示我上周收到的来自 Alice 的邮件" 或 "找到主题为 '会议记录' 的邮件"。

开发

• 添加查看邮件的工具。
• 添加查找和下载附件的工具。