AI导哈

财务服务器部署

Venly MCP Treasury Server是一款生产级的财务操作服务器，提供安全模式、健康监控、审计跟踪等功能，适用于企业财务管理和加密货币支付场景。

  • by timdierckxsens
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 timdierckxsens/venly-mcp-enterprise

使用说明

Venly MCP财务服务器-生产部署指南

🎯 这是什么

A. 生产级MCP服务器 为您的Venly资金运营提供：

  • ✅ 安全模式：防止意外的大额转账
  • ✅ 健康监测：铁路自动修复
  • ✅ 审计跟踪：记录到Google表格的每笔交易
  • ✅ 10/10生产就绪：已实施所有安全功能

🚀 15分钟CEO部署

步骤1：分叉此存储库

  1. 点击GitHub上的“分叉”按钮
  2. 命名它： venly-treasury-mcp
  3. 为了安全起见，请保密

第二步：部署到铁路（每月5美元）

OR手动设置：

  1. 首选 Railway.app
  2. 点击“新建项目”→ “从GitHub仓库部署”
  3. 选择您的分叉存储库
  4. 铁路自动检测配置

步骤3：配置环境变量

在铁路仪表板中，添加以下变量：

# REQUIRED - Get from https://portal.venly.io/
VENLY_CLIENT_ID=your-client-id
VENLY_CLIENT_SECRET=your-secret

# START WITH SANDBOX
VENLY_ENVIRONMENT=sandbox

# Your treasury wallet (create in Venly first)
TREASURY_WALLET_ID=your-wallet-uuid

# Safety settings (CRITICAL)
SAFE_MODE_MAX_AMOUNT=1000
AUDIT_LOG_ENABLED=true

步骤4：验证健康状况

部署后，请访问：

https://your-app.up.railway.app/healthz

您应该看到：

{
  "status": "healthy",
  "environment": "sandbox",
  "checks": {
    "venly_oauth": "healthy",
    "safe_mode": "enabled"
  }
}

步骤5：查看仪表板

访问：

https://your-app.up.railway.app/dashboard

📊 Google表格审核设置（推荐）

为什么你需要这个：

每个事务都会创建一个不可变的记录，这对合规性和调试至关重要。

设置（10分钟）：

  1. 创建谷歌表格:

    • 名称：“Venly MCP审核日志”
    • 与服务帐户电子邮件共享

  2. 创建服务帐户:

    1. Go to https://console.cloud.google.com
2. Create new project or select existing
3. Enable Google Sheets API
4. Create service account
5. Download JSON key

  3. 添加到铁路:

    AUDIT_PROVIDER=sheets
GOOGLE_SHEETS_CREDS=<paste entire JSON here>

🔗 集成点

对于n8n工作流：

// Add to n8n HTTP Request node
URL: https://your-app.up.railway.app/mcp
Method: POST
Headers: 
  Content-Type: application/json
Body:
{
  "jsonrpc": "2.0",
  "method": "venly_settle_invoice",
  "params": {
    "invoiceId": "INV-001",
    "recipientAddress": "0x...",
    "amount": "100",
    "chain": "POLYGON",
    "confirmed": true,
    "origin": "n8n"
  }
}

对于Claude Desktop：

添加到配置：

{
  "mcpServers": {
    "venly-treasury": {
      "command": "npx",
      "args": ["-y", "github:yourusername/venly-treasury-mcp"]
    }
  }
}

🛡️ 安全模式功能

在生产中，这些是强制执行的：

检查 限制 超过时采取行动
最大交易额 1000美元 已阻止
需要确认 confirmed: true 封锁了
允许的来源 n8n，内部 已阻止
警告阈值 $500 已记录

📈 生产检查表

首次真实交易前：

  • []测试 sandbox 环境
  • []创建测试交易<10美元
  • []验证审核日志是否捕获了它
  • []检查仪表板是否显示指标
  • []测试安全模式（尝试量>限制）
  • []验证健康端点是否返回200

走向生产：

  1. 改变环境:

    VENLY_ENVIRONMENT=production
TREASURY_WALLET_ID=<production-wallet-id>

  2. 小心增加限额:

    SAFE_MODE_MAX_AMOUNT=5000  # Based on your needs

  3. 设置警报:

    SLACK_ALERT_WEBHOOK=https://hooks.slack.com/...
ALERT_EMAIL=ceo@venly.io

🔧 可用工具

财务运营（高级）：

  • venly_settle_invoice -用美元支付发票
  • venly_batch_payouts -多次自由职业者付款
  • venly_get_treasury_position -查看所有余额

钱包操作（低级）：

  • venly_create_wallet -创建新钱包
  • venly_execute_transaction -发送代币
  • venly_get_balance -检查余额

📊 监控

需要关注的关键指标：

  1. 成功率 -应大于95%
  2. 上次成功发送 -应该是最近的
  3. 失败的交易 -调查任何故障
  4. 审核日志行 -应与交易计数匹配

铁路仪表板：

  • 日志：查看所有操作
  • 指标：CPU、内存使用情况
  • 部署：更新历史
  • 设置：环境变量

🚨 故障排除

“违反安全模式”

原因：交易超出限额或缺少确认 修复：检查金额并添加 confirmed: true

“超出费率限制”

原因：请求太多 修复：等待1分钟，请求自动恢复

“Venly OAuth不健康”

原因：凭据无效或Venly已关闭 修复：验证CLIENT_ID和CLIENT_SECRET

“事务超时”

原因：网络拥塞 修复：重试或检查区块浏览器

💰 成本细分

服务 成本 你得到什么
铁路 每月5美元 托管、自动扩展、监控
Venly 免费套餐→ $99/mo 基于交易量
谷歌表格 免费 审计日志
您的时间 15分钟 完成设置

🎯 您的特定用例（巴基斯坦银行）

自由职业者每月支付200万至400万美元：

  1. 使用批处理工具:

    venly_batch_payouts({
  payouts: [...freelancers],
  chain: "POLYGON",  // Lowest fees
  confirmed: true,
  origin: "n8n"
})

  2. 设定适当的限制:

    SAFE_MODE_MAX_AMOUNT=10000  # For larger batches

  3. 密切监视:

    • 最初每小时检查一次仪表板
    • 每天审查审计日志
    • 设置Slack警报

📞 支持升级

  1. 检查仪表板 -此处可见的大多数问题
  2. 查看审核日志 -看看到底发生了什么
  3. 检查铁路日志 -详细的错误消息
  4. Venly状态 - https://status.venly.io/
  5. 紧急情况 -禁用铁路，离线调查

✅ 在以下情况下，您已做好生产准备：

  • []健康检查显示全部为绿色
  • []已成功发送测试事务
  • []记录所有操作的审核日志
  • []安全模式阻止了测试超限交易
  • []n8n工作流已连接并测试
  • []仪表板已添加书签，可供每日查看

记住：开始于 sandbox，测试所有内容，然后切换到 production. 安全功能是你的朋友——它们可以防止代价高昂的错误。

专为需要可靠性而非复杂性的首席执行官而设计。 🚀

相关 MCP