Plaid MCP服务器（Python）
模型上下文协议（MCP）服务器，用于在沙箱模式下与Plaid的API集成。此服务器提供用于链接银行账户、检索交易、余额和账户信息的工具。
特性
- 创建用于Plaid链接初始化的链接令牌
- 将公共代币兑换为访问代币
- 检索帐户信息
- 获取日期范围内的交易记录
- 获取实时余额信息
先决条件
- Python 3.10或更高版本
- pip或uv包管理器
- 带有沙盒凭据的Plaid帐户
设置
1.获取Plaid证书
- 注册地址： 格子仪表板
- 导航到“开发人员”>“密钥”
- 复制您的
client_id和sandbox秘密
2.安装依赖项
使用pip：
pip install -e .或者使用紫外线（更快）：
uv pip install -e .3.配置环境
cp .env.example .env编辑 .env 并添加您的凭据：
PLAID_CLIENT_ID=your_client_id_here
PLAID_SECRET=your_sandbox_secret_here用法
运行服务器
python -m plaid_mcp_server.server或者，如果已安装：
plaid-mcp-server获取沙盒访问令牌
要进行测试，请运行沙盒设置脚本：
python sandbox_setup.py这将创建一个测试Plaid项目，并为您提供一个与MCP工具一起使用的访问令牌。
可用工具
1.创建链接令牌
创建用于初始化Plaid链接的链接令牌。
参数：
user_id（必填）：用户的唯一IDclient_name（必填）：您的申请名称products（可选）：产品数组（默认值：\[“事务”\]）country_codes（可选）：国家代码数组（默认值：\[“US”\]）language（可选）：语言代码（默认值：“en”）
2.交换_公共_代币
将公共令牌交换为访问令牌。
参数：
public_token（必填）：来自Plaid Link的公共令牌
3.获取计数
检索帐户信息。
参数：
access_token（必需）：链接项目的访问令牌
4.获取交易
获取日期范围内的交易记录。
参数：
access_token（必需）：链接项目的访问令牌start_date（必填）：开始日期（YYYY-MM-DD）end_date（必填）：结束日期（YYYY-MM-DD）
5.平衡
获取实时余额信息。
参数：
access_token（必需）：链接项目的访问令牌
沙盒测试
服务器已配置为使用Plaid的沙盒环境。使用Plaid Link进行测试时使用这些测试凭据：
- 用户名：
user_good - 密码：
pass_good
看 Plaid的沙盒指南 了解更多测试凭据和场景。
发展
项目结构
plaid-mcp-python/
├── src/
│ └── plaid_mcp_server/
│ ├── __init__.py
│ └── server.py # Main MCP server implementation
├── sandbox_setup.py # Script to create test access tokens
├── requirements.txt # Python dependencies
├── pyproject.toml # Project metadata and build config
├── .env.example # Environment variables template
└── README.md代码的风格
此实现遵循Python最佳实践：
- 提供更好的IDE支持和类型检查的类型提示
- 异步/等待并发操作
- 针对特定异常的正确错误处理
- PEP 8风格指南合规性
- 所有模块和函数的文档字符串
连接到克劳德桌面
要将此MCP服务器与Claude Desktop一起使用，请将以下内容添加到您的Claude Desktop配置中：
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"plaid": {
"command": "python",
"args": ["-m", "plaid_mcp_server.server"],
"cwd": "/absolute/path/to/plaid-mcp-python",
"env": {
"PLAID_CLIENT_ID": "your_client_id_here",
"PLAID_SECRET": "your_sandbox_secret_here"
}
}
}
}或者，如果使用紫外线：
{
"mcpServers": {
"plaid": {
"command": "uv",
"args": ["run", "plaid-mcp-server"],
"cwd": "/absolute/path/to/plaid-mcp-python",
"env": {
"PLAID_CLIENT_ID": "your_client_id_here",
"PLAID_SECRET": "your_sandbox_secret_here"
}
}
}
}更新配置后，重新启动Claude Desktop。
许可证
麻省理工学院