Mybambu Transfers Production

MyBambu转让-生产版本

⚠️ 这是带有真实支付API的生产版本 有关模拟传输的演示版本，请参阅： chatgpt传输

通过具有真实银行API的ChatGPT直接向拉丁美洲汇款 💸

一个生产MCP（模型上下文协议）服务器，支持 真正的国际汇款 通过ChatGPT使用Wise API、Plaid和其他支付提供商。遵循OpenAI Apps SDK最佳实践构建，具有交互式小部件、实时汇率和生产级安全性。

📖 集成指南

看 集成_指南.md 有关完整的设置说明 包括：

• 明智的API集成
• 支付提供商设置（Plaid、dLocal、Currencyloop）
• 数据库配置
• KYC/AML合规
• 安全最佳实践

 

✨ 特性

🌎 国际转账

• 17+拉丁美洲国家 -墨西哥、危地马拉、洪都拉斯、多米尼加共和国、哥伦比亚、秘鲁、厄瓜多尔、萨尔瓦多、尼加拉瓜、哥斯达黎加等
• 超低费用 -起价仅0.85美元（1.5%，最低2.99美元，最高50美元）
• 快速配送 -对于特定走廊，最快可达35分钟
• 实时汇率 -从exchange-api.com每小时更新一次

🎨 交互式小部件

使用OpenAI Apps SDK构建，具有以下特点：

• 转账收据小部件 -带有状态跟踪功能的精美动画收据
• 汇率小部件 -带有动画背景的实时房价
• 传输历史小部件 -点击浏览过去的转账以查看详细信息
• windows.openai集成 -完整的交互功能

🛠️ 五大强大工具

1. send_money -启动国际转账
2. get_exchange_rate -查看实时汇率
3. check_transfer_status -跟踪传输进度
4. get_transfer_history -查看所有过去的转账
5. get_supportd_国家 -列出所有支持的走廊

🚀 快速开始

1.安装依赖项

pnpm install

2.启动服务器

pnpm start

服务器在上运行 http://localhost:8000

3.公开曝光

选项1:ngrok（推荐）

npx ngrok http 8000

选项2：本地隧道

npx localtunnel --port 8000

选项3:Cloudflare隧道

cloudflared tunnel --url http://localhost:8000

4.连接到ChatGPT

1. 启用开发人员模式

- 打开ChatGPT设置→ 应用程序和连接器 - 启用“高级设置”→ “开发人员模式”

1. 创建连接器

- 转到连接器→ 创建 - 名字：MyBambu转账 - 描述：向拉丁美洲汇款，费用低，交货快 - 统一资源定位符: https://your-public-url.com/mcp

1. 测试一下！

- 开始新的聊天 - 点击 + 按钮→ 选择“MyBambu转账” - 尝试： *“寄100美元到墨西哥”*

💬 用法示例

汇款

You: Send $100 to Maria in Mexico
ChatGPT: [Shows interactive receipt widget with transfer details]

查看汇率

You: What's the exchange rate from USD to MXN?
ChatGPT: [Shows beautiful rate widget with live data]

查看历史

You: Show me my transfer history
ChatGPT: [Shows history widget with all past transfers]

检查状态

You: Check status of TXN-1001
ChatGPT: [Shows updated receipt with current status]

支持的国家

You: Which countries does MyBambu support?
ChatGPT: [Lists all 17+ supported corridors with delivery times]

🏗️ 建筑

MCP服务器结构

src/server.ts
├── Component Resources (HTML widgets)
│   ├── Transfer Receipt Widget
│   ├── Exchange Rate Widget
│   └── Transfer History Widget
├── Tools (5 total)
│   ├── send_money
│   ├── get_exchange_rate
│   ├── check_transfer_status
│   ├── get_transfer_history
│   └── get_supported_countries
└── Mock MyBambu API
    └── simulateMyBambuTransfer()

应用SDK集成

组件资源 (text/html+skybridge mimeType）

• 通过暴露 ListResourcesRequestSchema
• 通过以下方式提供服务 ReadResourceRequestSchema
• 互动与 window.openai API

工具元数据 （适当 _meta 字段）

• openai/outputTemplate -小部件组件链接
• openai/toolInvocation -状态消息
• readOnlyHint / destructiveHint -行为暗示

响应结构

{
  content: [...],           // For ChatGPT conversation
  structuredContent: {...}, // For widget (window.openai.toolOutput)
  _meta: {...}             // For widget only (window.openai.toolResponseMetadata)
}

🎨 小部件功能

交互操作

转账收据小部件：

• “检查状态”按钮→ Calls check_transfer_status 工具
• “查看历史记录”按钮→ 发送后续消息

汇率小部件：

• “立即汇款”按钮→ 启动传输流

传输历史小部件：

• 点击任何转账→ 显示完整收据

🌍 支持的走廊

*更多国家即将到来！*

📦 部署

渲染（当前设置）

存储库包括 render.yaml 对于一键部署：

1. 推送到GitHub
2. 首选https://render.com
3. New → Web服务
4. 连接您的GitHub仓库
5. Render自动检测Render.yaml中的配置

铁路

包含 railway.json 用于部署：

npm install -g @railway/cli
railway login
railway up

码头工人

docker build -t mybambu-transfers .
docker run -p 8000:8000 mybambu-transfers

🛠 发展

pnpm start      # Start production server
pnpm dev        # Start with auto-reload

🎯 路线图

第一阶段：MVP（当前）✅

• \[x\] 具有Apps SDK最佳实践的MCP服务器
• \[x\] 带有window.openai的交互式小部件
• \[x\] 5种转账和费率工具
• \[x\] 模仿MyBambu API
• \[x\] 带有动画的漂亮UI
• \[x\] 17+国家支持

第二阶段：生产

• \[\]Real MyBambu API集成
• \[\]OAuth 2.1身份验证
• \[\]PostgreSQL数据库
• \[\]事务持久性
• \[\]Webhook状态更新

______________________________________________________________________

内置于❤️ 为拉丁裔社区 🌎