内容
# 稳定MCP服务器
一个适用于 [稳定](https://www.usestable.com) 的 [MCP](https://modelcontextprotocol.io) 服务器，这是一个虚拟邮箱和商业地址服务。连接克劳德（或任何支持MCP的AI助手）到您的稳定邮箱，以便它可以：
- 📬 **列出您的邮件** — 发件人、收件人、扫描状态、标签、查看/存款/转发状态
- 📖 **阅读扫描的信件** — 拉取扫描的OCR文本，以便您的助手可以为您读取实际内容（“给我读一下来自IRS的信件”）
- 🏷️ **使用标签组织** — 创建标签并在邮件项目中应用或删除
- 📍 **列出您的位置** — 账户中的每个地址
**零依赖。** 它是一个单独的Python文件，可以在macOS（3.9+）自带的Python上运行。无需 `pip install`，无需Node.js，无需构建步骤。
> **注意：** 稳定的公共API目前仅限于读取和组织。请求扫描、转发、粉碎或检查存款仍需要在稳定仪表板中进行。
## 设置
### 1. 获取服务器
```bash
git clone https://github.com/travisthetrashpanda/stable-mcp.git
```
或者直接下载 `server.py` — 它就是整个服务器。
### 2. 添加您的API密钥
在 [dashboard.usestable.com/settings/api-keys](https://dashboard.usestable.com/settings/api-keys) 处创建API密钥，然后将其保存在服务器旁边：
```bash
cd stable-mcp
echo "您的API密钥" > api_key.txt
chmod 600 api_key.txt
```
（`api_key.txt` 被git忽略，因此无法提交。或者，在MCP客户端配置文件中设置 `STABLE_API_KEY` 环境变量，然后跳过该文件。）
### 3. 连接您的客户端
**克劳德代码：**
```bash
claude mcp add --scope user stable -- python3 /path/to/stable-mcp/server.py
```
**克劳德桌面** — 添加到 `claude_desktop_config.json` （设置 → 开发者 → 编辑配置）：
```json
{
"mcpServers": {
"stable": {
"command": "python3",
"args": ["/path/to/stable-mcp/server.py"]
}
}
}
```
**光标/其他MCP客户端** — 任何支持stdio MCP服务器的客户端都可以使用相同的命令：`python3 /path/to/stable-mcp/server.py`
在添加服务器后重启您的客户端。
## 尝试
询问您的助手类似的问题：
- “本周有新邮件吗？”
- “给我读一下来自福特信贷的信”
- “哪些邮件项目中有支票？”
- “将县来的所有邮件标记为‘财产税’”
## 工具
| 工具 | 功能 |
|---|---|
| `list_mail_items` | 列出带有过滤器（位置、日期范围、扫描状态）和分页的邮件 |
| `get_mail_item` | 邮件项目的完整详细信息，包括扫描摘要和图像URL |
| `get_mail_scan_text` | 获取扫描信件的OCR文本，以便助手可以读取 |
| `list_locations` | 账户中的所有地址 |
| `list_tags` | 所有标签（ID + 名称） |
| `create_tags` | 创建新标签 |
| `set_mail_item_tags` | 在一个或多个邮件项目上应用/删除标签 |
## 安全说明
- 您的API密钥保留在您的机器上。服务器仅与 `api.usestable.com` （以及稳定预签名扫描文档URL，当您要求读取信件时）通信。
- 将密钥视为密码：它授予对您的邮件的访问权限，其中可能包含敏感文档和支票。
- 您的助手读取的任何内容（邮件内容、发件人）都成为您与它的对话的一部分。
## 表示感谢
该项目免费使用，无附加条件。如果它对您有用，在此仓库上点赞或向 [@travisthetrashpanda](https://github.com/travisthetrashpanda) 致谢始终是受欢迎的 — 如果您在此基础上构建了某些内容，链接回此处有助于其他稳定用户找到它。
## 许可证
MIT
