内容
# plaid-mcp
一款暴露 Plaid 沙盒交易的模型上下文协议（MCP）服务器，供 AI 代理使用。
## 概述
该 MCP 服务器封装了 Plaid 的沙盒环境，提供了 3 种任务形状的工具，AI 代理可以使用这些工具查询金融数据，而无需直接管理 Plaid 令牌。
## 工具
| 工具 | 描述 | 参数 |
|------|-------------|-----------|
| `list_accounts` | 返回所有具有余额的沙盒账户 | 无 |
| `list_recent_transactions` | 返回近期交易 | `days_back: int（1-365，默认 30）` |
| `list_transactions_by_category` | 按类别筛选交易 | `category: str`，`days_back: int` |
## 快速入门
### 1. 获取 Plaid 沙盒凭证
1. 在 https://dashboard.plaid.com/signup 注册
2. 导航到 **开发者 → 密钥**
3. 复制您的 **client_id** 和 **沙盒密钥**
### 2. 配置环境
```bash
cp .env.example .env
# 使用您的凭证编辑 .env
```
### 3. 安装和运行
```bash
# 安装依赖项
uv sync
# 在 stdio 模式下运行（适用于 Claude Code / 编排器）
uv run python server.py
# 或在 HTTP 模式下运行
MCP_TRANSPORT=streamable-http uv run python server.py
```
## 与 Claude Code 一起使用
```bash
claude mcp add plaid-mcp uv run python /path/to/plaid-mcp/server.py
```
示例提示：
- "我有哪些账户？"
- "这个月我花了多少钱买食物？”
- “给我看看我最近的交易”
## 使用 Docker
```bash
docker compose up
```
服务器将在 `http://localhost:8001/mcp` 上可用。
## 架构
- **单令牌模式**：服务器在首次使用时生成 Plaid 沙盒访问令牌，并将其缓存在 `.cache/plaid.json` 中。代理不需要管理令牌。
- **任务形状的工具**：3 个高级别工具，而不是原始 Plaid API 端点。
- **双重传输**：stdio 用于子进程编排，streamable-http 用于 Docker/HTTP 客户端。
## 许可证
MIT
