Servidor MCP Efí
Node.js 服务器为 Efi Bank API 操作实现模型上下文协议 （MCP）。
特征
- 即时PIX收费管理
- PIX付款和转账
- PIX 退货操作
- Webhooks 配置
- 账户余额和设置
- EVP（随机密钥）管理
- MED（特殊退款机制）
安装
NPX
npx mcp-server-efi码头工人
docker run -i --rm mcp-server-efi \
--sandbox=false \
--client-id=seu_client_id \
--client-secret=seu_client_secret \
--certificate=seu_certificado_base64 \
--validate-mtls=true配置
服务器需要以下环境变量：
sandbox定义为"false"生产或"true"环境沙箱client-id您的Efí银行应用程序客户IDclient-secret您的银行应用程序的秘密客户certificate您的Efí银行证书以Base64格式validate-mtls定义为"true"验证 webhooks 中的 mTLS（可选，默认为 true）
API
PIX 即时收费
- pix_create_immediate_charge
- 无需指定 txid 即时创建 PIX 账单 - 生成到期时间，金额，PIX密钥和可选债务人信息的收费
- pix_create_charge
- 使用指定的 txid 创建即时的 PIX 账单 - 输入：txid，收费细节（金额，PIX密钥，债务人信息等）
- pix_update_charge
- 更新现有的 txid 收费 - 修改到期、债务人信息、价值或其他信息
- pix_detail_charge
- 获取 txid 账单详情 - 返回完整的计费信息，包括付款状态和详细信息
- pix_list_charges
- 列出带过滤器选项的收费 - 按日期范围、CPF/CNPJ、状态和分页过滤
PIX付款和转账
- pix发送
- 将 PIX 付款发送到 PIX 密钥或银行账户 - 支持PIX密钥或银行帐户详细信息作为目标
- pix_send_detail
- 获取 e2eId 发送的 PIX 细节 - 返回完整的交易信息
- pix_send_list
- 用过滤器选项列出已发送的 PIX 交易 - 按日期范围、状态和退货状态过滤
- pix_qr_code_pay
- Pagar二维码PIX通过API - 使用付款人信息处理QR码付款
PIX 管理
- pix_detail_已收到
- 获取由 e2eId 接收的 PIX 详细信息 - 返回交易和退货信息
- pix接收列表
- 列出已收到的 PIX 交易 - 按日期、txid、CPF/CNPJ过滤，支持分页
- pix权力下放
- 创建 PIX 退货 - 输入：e2eId，退货ID和价值
- pix_detail_devolution
- 通过e2eId和退货ID获取退货详情
网页插件
- pix_config_网钩
- 配置 PIX 通知的 webhook URL - 设置交易通知的 webhook 端点
- pix_detail_网钩
- 通过 PIX 键获取 webhook 配置详细信息
- pix_list_网钩
- 列出所有已配置的 webhook
- pix_delete_网钩
- 删除 PIX 键的 webhook 配置
- pix_resend_网钩
- 为特定交易重新发送 webhook 通知
账户管理
- get_count_balance
- 获取当前账户余额 - 返回可用余额信息
- update_account_config
- 更新账户 PIX 设置 - 配置 PIX 密钥设置、限制和 webhook 首选项
- list_account_config
- 列出当前账户设置 - 返回所有 PIX 和账户设置
EVP（随机密钥）管理
- pix_create_evp
- 创建新的随机 PIX 密钥（ EVP） - 生成 PIX 交易的随机密钥
- pix_list_evp
- 列出所有已注册的 EVP 密钥
- pix_delete_evp
- 删除特定 EVP 密钥
医学
- med_list
- 列出针对账户的公开MED违规行为 - 按分页日期范围过滤
附加功能
- pix_get_receipt
- 获取交易证明（PDF格式） - 使用 e2eId、 txid 或 rtrId 生成凭证
Uso-com克劳德桌面
将它添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"mcp-server-efi": {
"command": "npx",
"args": [
"mcp-server-efi",
"--sandbox=false",
"--client-id=seu_client_id",
"--client-secret=seu_client_secret",
"--certificate=seu_certificado_base64",
"--validate-mtls=true"
]
}
}
}
Uso-com Docker没有克劳德桌面
{
"mcpServers": {
"mcp-server-efi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp-server-efi",
"--sandbox=false",
"--client-id=seu_client_id",
"--client-secret=seu_client_secret",
"--certificate=seu_certificado_base64",
"--validate-mtls=true"
]
}
}
}Uso-com VS代码
若要手动安装，请将以下内容添加到 VS Code 设置或 .vscode/mcp.json:
NPX
{
"mcp": {
"servers": {
"mcp-server-efi": {
"command": "npx",
"args": [
"mcp-server-efi",
"--sandbox=false",
"--client-id=seu_client_id",
"--client-secret=seu_client_secret",
"--certificate=seu_certificado_base64",
"--validate-mtls=true"
]
}
}
}
}码头工人
{
"mcp": {
"servers": {
"mcp-server-efi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp-server-efi",
"--sandbox=false",
"--client-id=seu_client_id",
"--client-secret=seu_client_secret",
"--certificate=seu_certificado_base64",
"--validate-mtls=true"
]
}
}
}
}构建
地方 发展
npm install
npm run build
npm start构建Docker
docker build -t mcp-server-efi .安全说明
- 始终使用生产凭据 （
sandbox=false对于实际交易 - 确保您的证书和凭据安全
- 启用 mTLS 验证 （
validate-mtls=trueWebhook的安全性 - 所有API调用均使用Efí Pay的OAuth 2.0实现进行身份验证
支持
有关 Efí Pay API 文档和支持，请访问：https://dev.efipay.com.br/