使用说明
火花mcp
只读MCP服务器 Spark桌面 电子邮件。直接查询Spark的本地SQLite数据库——没有IMAP连接,没有API密钥,没有网络访问。
Claude Code快速入门
# 1. Clone and install
git clone https://github.com/bbdaniels/spark-mcp.git
cd spark-mcp && pip install -e .
# 2. Register the MCP server (one-liner)
claude mcp add spark-email -- spark-mcp
就是这样。重新启动Claude Code,您就可以搜索、阅读和浏览您的Spark电子邮件。
它做什么
让Claude(或任何MCP客户端)以只读方式访问您的Spark电子邮件:
- 搜索 使用Spark的全文搜索索引跨所有帐户
- 阅读 带有全文的个人消息
- 浏览 最近的收件箱、对话线程、文件夹、联系人
需求
- 安装了Spark Desktop的macOS
- Python 3.10+
mcpPython包
安装
git clone https://github.com/bbdaniels/spark-mcp.git
cd spark-mcp
pip install -e .
使用克劳德代码注册
claude mcp add spark-email -- spark-mcp
这登记了 spark-mcp 控制台脚本(由安装 pip install -e .)作为名为的MCP服务器 spark-email。您还可以使用模块入口点:
claude mcp add spark-email -- python3 -m spark_mcp.server
工具
| 工具 | 说明 |
|---|---|
spark_list_accounts |
列出已配置的电子邮件帐户 |
spark_search |
在所有帐户中进行全文搜索 |
spark_get_message |
阅读带有正文和附件的特定邮件 |
spark_get_conversation |
阅读电子邮件帖子 |
spark_recent |
列出最近的收件箱邮件 |
spark_search_contacts |
按姓名或电子邮件搜索联系人 |
spark_list_folders |
列出每个帐户的文件夹/标签 |
安全
- 所有数据库访问都是 只读 (SQLite
?mode=ro) - 无网络连接--仅从本地磁盘读取
- 无需凭据——使用Spark现有的本地缓存