Spark邮件读取服务

提供对Spark电子邮件的只读访问,包括搜索、阅读和浏览功能,无需网络连接或API密钥。

  • by bbdaniels
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bbdaniels/spark-mcp

使用说明

火花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+
  • mcp Python包

安装

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现有的本地缓存