序列银行MCP服务器
⚠️ 非官方： 这是一个非官方的、由社区构建的MCP服务器。它不隶属于、不受Sequence认可或支持。
MCP（模型上下文协议）服务器，提供对 序列 API银行业务。这允许像Claude这样的AI助手以编程方式与您的Sequence帐户进行交互。
特性
- 获取帐户：获取所有当前余额的金融账户（Pod、收入来源、外部账户）
- 触发规则：从外部系统调用按顺序配置的自动化规则
需求
- Python 3.10或更高版本
- 启用了外部API的序列帐户
- 从序列仪表板访问令牌和/或规则API机密
安装
- 克隆或下载此存储库
- 创建并激活虚拟环境：
python3 -m venv venv
source venv/bin/activate- 安装软件包：
pip install -e .- 对于开发（包括测试依赖关系）：
pip install -e ".[dev]"配置
获取您的凭据
- 启用外部API：前往序列仪表板中的“设置”>“启用远程API”
- 生成访问令牌：导航到“帐户设置”>“访问令牌”并创建新令牌。这用于获取帐户数据。
- 获取规则API机密：创建具有“远程API”触发器类型的规则时，将生成API机密。使用此秘密触发特定规则。
环境变量
将您的访问令牌设置为环境变量：
export SEQUENCE_ACCESS_TOKEN="your_access_token_here"用法
运行MCP服务器
source venv/bin/activate
python -m sequence_mcp.server与Claude Desktop一起使用
将以下内容添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sequence": {
"command": "/path/to/sequence-mcp/venv/bin/python",
"args": ["-m", "sequence_mcp.server"],
"env": {
"SEQUENCE_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}替换 /path/to/sequence-mcp 与这个项目的实际路径。
可用工具
获取计数
获取所有金融账户的当前余额。
需求: SEQUENCE_ACCESS_TOKEN 必须设置环境变量。
退货：包含id、名称、类型和余额信息的帐户列表。
触发规则
在序列中触发自动化规则。
参数:
rule_id（必填）：要触发的规则的ID（例如，“ru_12345”）api_secret（必需）：与此规则关联的API机密payload（可选）：与触发器一起发送的JSON对象idempotency_key（可选）：用于防止重试时重复触发的唯一键
发展
设置
# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate
# Install development dependencies (includes testing tools)
pip install -e ".[dev]"运行测试
# Run all tests
pytest -v
# Run with coverage report
pytest --cov=sequence_mcp
# Run specific test file
pytest tests/test_client.py -v
# Run specific test function
pytest tests/test_client.py::describe_SequenceClient::describe_get_accounts -v测试使用 pytest-describe BDD风格的组织和 respx 用于HTTP模拟。
项目结构
sequence-mcp/
├── sequence_mcp/
│ ├── __init__.py # Package exports
│ ├── models.py # Pydantic models for API responses
│ ├── client.py # Async HTTP client for Sequence API
│ └── server.py # MCP server implementation
├── tests/
│ ├── conftest.py # Shared test fixtures
│ ├── test_models.py # Model tests
│ ├── test_client.py # Client tests
│ └── test_server.py # Server tests
├── pyproject.toml # Project configuration
└── README.mdAPI 参考
此MCP服务器包装序列外部API。有关API的完整文档，请参阅： https://support.getsequence.io/hc/en-us/articles/42813911824019-API-Overview
错误代码
| 代码 | 描述 |
|---|---|
INVALID_ACCESS_TOKEN | 访问令牌丢失或无效 |
INVALID_API_SECRET | 规则API机密不正确 |
INVALID_REQUEST | 找不到规则ID或未为API触发器配置规则ID |
TOO_MANY_REQUESTS | 超过速率限制，减慢请求速度 |
UNEXPECTED_ERROR | 服务器错误，通常是暂时的 |
安全说明
- 保护您的访问令牌和API机密的安全
- 切勿在客户端代码中公开凭据
- 使用环境变量或安全密钥管理
- 定期旋转令牌
- 所有请求都是通过HTTPS发出的
许可证
麻省理工学院