Cloudflare电子邮件MCP服务器
用于Cloudflare KV操作和从ProtonMail Bridge到Cloudflare KV命名空间的自动电子邮件处理的全面模型上下文协议服务器。
特性
KV操作
- 密钥管理：列出、计数、获取、放置、删除任何KV命名空间中的键
- 分页：使用基于光标的分页处理大型数据集
- 批量操作：高效检索多个密钥
电子邮件处理
- 自动转移：将电子邮件从特定的IMAP文件夹移动到相应的KV命名空间
- UUID v5主体ID：具有独立存储的确定性车身识别
- 文件夹映射：法院、政府和法律通信的预配置映射
- 状态跟踪：工作流管理的待定/已处理状态
建筑
双层存储
Court KV Namespace:
├── Key: 2026.02.09_casework_ico_org_uk_10-30-45
└── Value: {
"from": "casework@ico.org.uk",
"to": "rose@mobicycle.ee",
"subject": "Your complaint reference IC-...",
"body": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"namespace": "ICO Complaints",
"status": "pending"
}
Body KV Namespace (by year):
├── Key: f47ac10b-58cc-4372-a567-0e02b2c3d479
└── Value: { "text": "Dear Ms Liu..." }文件夹映射
自动处理来自以下来源的电子邮件：
- 法院：上诉、衡平法院、行政法院、王座法院、最高法院等。
- 政府：GLD，美国国务院，爱沙尼亚政府
- 投诉：HMCTS、ICO、PHSO、律师标准、议会
- 政党：刘诉讼、香港法律、承租人财产等。
设置
先决条件
- Bun运行时
- ProtonMail桥在本地运行
- 具有KV访问权限的Cloudflare帐户
- Wrangler CLI已配置
认证
服务器自动使用Wrangler OAuth令牌：
wrangler auth login安装
bun install
bun run build
bun start用法
MCP工具
KV操作
// Count keys in a namespace
kv_keys_count({
namespace_id: "your-namespace-id",
prefix: "email:"
})
// List keys with pagination
kv_keys_list({
namespace_id: "your-namespace-id",
prefix: "2026.02",
limit: 100,
cursor: "next-page-cursor"
})
// Get/set individual values
kv_key_get({ namespace_id: "...", key: "..." })
kv_key_put({ namespace_id: "...", key: "...", value: "..." })电子邮件处理
// Transfer emails from approved folders
email_transfer_folders({
folders: ["INBOX/Courts/Supreme"],
since: "2026-02-01T00:00:00Z",
dry_run: true
})
// Check processing stats
email_folder_stats({
folder_name: "INBOX/Complaints/ICO"
})
// List all folders and their approval status
email_list_folders()配置
已批准的文件夹
只有预配置的文件夹会自动同步到KV：
- 法律信函文件夹
- 法庭通信
- 政府机构
- 投诉系统
KV命名空间
- 法院名称空间：每个管辖区一个
- 尸体存放处：按年份分开(
email-bodies-2026) - 帐户映射：网桥gRPC帐户信息
发展
项目结构
src/
├── index.ts # Main MCP server with stdio transport
├── cloudflare-api.ts # KV operations via Cloudflare API
└── email-processor.ts # IMAP to KV sync logic
dist/ # Built JavaScript
README.md # This file
package.json # Dependencies and scripts建筑
bun run build # TypeScript compilation
bun run dev # Watch mode测试
# Dry run email processing
email_transfer_folders({ dry_run: true })
# Test KV operations
kv_keys_count({ namespace_id: "test-namespace" })整合
克劳德代码MCP配置
添加到克劳德代码MCP设置：
{
"mcpServers": {
"cloudflare-email": {
"command": "bun",
"args": ["start"],
"cwd": "/path/to/this/directory"
}
}
}环境变量
# Optional - detected automatically from wrangler
CLOUDFLARE_API_TOKEN=your-token
CLOUDFLARE_ACCOUNT_ID=your-account-id自动化
桥梁集成
使用ProtonMail Bridge gRPC进行帐户映射：
- 网桥重启时自动捕获令牌
- 账户结构推送到KV
- 防止电子邮件重复计数
工作流程
- Bridge在配置的文件夹中接收电子邮件
- MCP服务器将新电子邮件同步到KV命名空间
- 人工智能分流系统处理待处理的电子邮件
- 状态更新跟踪工作流进度
许可证
内部MobiCycle OÜproject-不用于公共分发