Sequence MCP

序列银行MCP服务器

 

⚠️ 非官方： 这是一个非官方的、由社区构建的MCP服务器。它不隶属于、不受Sequence认可或支持。

MCP（模型上下文协议）服务器，提供对 序列 API银行业务。这允许像Claude这样的AI助手以编程方式与您的Sequence帐户进行交互。

特性

• 获取帐户：获取所有当前余额的金融账户（Pod、收入来源、外部账户）
• 触发规则：从外部系统调用按顺序配置的自动化规则

需求

• Python 3.10或更高版本
• 启用了外部API的序列帐户
• 从序列仪表板访问令牌和/或规则API机密

安装

1. 克隆或下载此存储库

1. 创建并激活虚拟环境：

   python3 -m venv venv
   source venv/bin/activate

1. 安装软件包：

   pip install -e .

1. 对于开发（包括测试依赖关系）：

   pip install -e ".[dev]"

配置

获取您的凭据

1. 启用外部API：前往序列仪表板中的“设置”>“启用远程API”

1. 生成访问令牌：导航到“帐户设置”>“访问令牌”并创建新令牌。这用于获取帐户数据。

1. 获取规则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.md

API 参考

此MCP服务器包装序列外部API。有关API的完整文档，请参阅： https://support.getsequence.io/hc/en-us/articles/42813911824019-API-Overview

错误代码

安全说明

• 保护您的访问令牌和API机密的安全
• 切勿在客户端代码中公开凭据
• 使用环境变量或安全密钥管理
• 定期旋转令牌
• 所有请求都是通过HTTPS发出的

许可证

麻省理工学院