Ripio (community, read-only)

ripio-community-mcp

非官方社区项目，与 Ripio 无关联。只读。使用风险自负。

一个本地 MCP 服务，让 AI 助手使用你自己的 API 密钥读取 Ripio 账户信息（余额、活动记录、价格、限额、未完成订单和存款地址）。它在你的电脑上运行，且只与 api.ripio.com 通信。

🇦🇷 西班牙语说明：README.es.md

为什么使用它，而不是 Ripio 官方 MCP？

Ripio 提供官方远程 MCP 服务。如果它能满足你的需求，就使用它。本项目旨在满足它无法覆盖的场景：

	官方（api.ripio.com/mcp）	ripio-community-mcp
客户端	仅限 Ripio 批准的 OAuth 客户端（Claude、ChatGPT、VS Code）	任何可运行本地（stdio）服务的 MCP 客户端：Claude Desktop/Code、Cursor、VS Code、Zed、Cline…
身份验证	在浏览器中使用 OAuth	你的 Ripio API 密钥，存储在本地
工具	约 70 个端点镜像	10 个可回答完整问题的工具
只读	取决于你选择的权限预设	内置：服务只能发送 GET 请求
工具元数据	没有只读/破坏性操作标注	每个工具都标注为只读，并提供类型化输出
能否转移资金	可以，使用 Full 预设	不可以

两者都无法显示银行卡交易、应用内买卖或账单支付：Ripio 的公开 API 不提供这些数据。

工具

工具	可以这样提问
ripio_get_portfolio	“我在 Ripio 有多少资产？分别是什么？”
ripio_list_activity	“我最近有哪些提现？”·“显示我 9 月的 Ripio Trade 对账单”
ripio_get_transaction	“给我交易 1234 的详细信息”
ripio_get_prices	“现在 USDT 的价格是多少？分别看应用内和 Ripio Trade 的价格。”
ripio_estimate_trade	“在 Ripio Trade 上买 100 USDT 要花多少钱？”
ripio_get_limits	“我今天还可以提现多少？”
ripio_list_open_orders	“我有未完成的订单吗？”
ripio_get_deposit_address	“通过 Tron 转账 USDT 应该发送到哪个地址？”
ripio_verify_deposit_address	“这个地址确实是我的吗？我准备通过 Polygon 转账 USDT”
ripio_get_deposit_accounts	“我的 CVU 和别名是什么？”

充值安全

网络选错、漏填备注或输错一个字符，都可能导致资金丢失，因此充值设有额外保障：

1. 精确输出。 地址和备注会原样返回 Ripio 提供的内容。服务端不会创建地址：如果 Ripio 尚未为某个网络分配地址，它会提示你在 Ripio 应用中发起该笔充值。
2. 网络规则。 在网络明确之前，ripio_get_deposit_address 不会返回地址。除了地址，它还会列出哪些网络可使用该地址为资产入账，以及哪些网络需要使用其他地址。你的 EVM 地址在所有 EVM 网络上都相同，但 Ripio 只支持在其中部分网络上为每种资产入账。
3. 代码验证。 助手会重新输入它读取到的内容，而大模型偶尔可能会改动一个字符。发送前，请粘贴你实际要使用的地址，并要求验证：ripio_verify_deposit_address 会将其与真实地址逐字符比对，并标记相似但不完全匹配的地址。
4. 网络校验和。 大多数网络（采用混合大小写地址的 EVM、Tron、Bitcoin、XRP、Stellar……）都有校验和，因此发送钱包通常会拒绝输入错误的地址。Solana 地址没有校验和。

对于大额转账，请先发送一笔小额测试充值。这些是 Ripio 应用（Wallet）的地址；Ripio Trade 使用不同的地址。

汇入你 CVU 的比索会按 Ripio 应用个人资料中设置的充值币种入账：如果设置的是加密货币，系统会自动兑换。ripio_get_deposit_accounts 会提醒你这一点。

设置

1. 在 Ripio 中创建只读 API 密钥

以下步骤使用 Ripio 英文界面中的标签。如果你的界面是西班牙语，请在 个人资料 → 偏好设置 → 语言 中切换语言，或参阅 README.es.md。

1. 打开 app.ripio.com，点击右上角的头像 → 个人资料 → API 选项卡 → 新建密钥。
2. IP 限制： 选择 指定 IP 并添加你的公网 IP（推荐），或选择 不限制。家庭网络连接的公网 IP 时不时会变化；发生这种情况时，服务端会返回 403，直到你将新的 IP 添加到密钥中。
3. 为密钥命名，并保留 只读预设（查询 9/9、在 Ripio 内操作 0/3、提现和地址 0/2）。
4. 使用你的 2FA 方式确认，然后复制 API Key 和 Secret Key。密钥只会显示一次。

Ripio 的“只读”预设仍允许 API 密钥以你本人的名义登记银行账户。本服务端绝不会调用该端点。

2. 将其添加到客户端

Claude Desktop（最简单）。 从最新版本下载 ripio-community-mcp.mcpb。在 Claude Desktop 中，前往 Settings → Extensions → Advanced settings → Install Extension…，选择该文件，并在提示时粘贴 API 密钥和密钥。Claude Desktop 会将它们保存在系统密钥链中。然后在普通聊天中提问，例如“我在 Ripio 有多少钱，都是什么资产？”

Claude Code

claude mcp add --env RIPIO_API_KEY=your-key --env RIPIO_API_SECRET=your-secret --transport stdio ripio -- npx -y ripio-community-mcp

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "ripio": {
      "command": "npx",
      "args": ["-y", "ripio-community-mcp"],
      "env": { "RIPIO_API_KEY": "your-key", "RIPIO_API_SECRET": "your-secret" }
    }
  }
}

VS Code（.vscode/mcp.json；如需用于所有工作区，请选择 MCP: Open User Configuration）。VS Code 会提示输入密钥和密钥，并将它们安全地保存：

{
  "inputs": [
    { "type": "promptString", "id": "ripio-key", "description": "Ripio API key", "password": true },
    { "type": "promptString", "id": "ripio-secret", "description": "Ripio secret key", "password": true }
  ],
  "servers": {
    "ripio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ripio-community-mcp"],
      "env": { "RIPIO_API_KEY": "${input:ripio-key}", "RIPIO_API_SECRET": "${input:ripio-secret}" }
    }
  }
}

Zed（settings.json）

{
  "context_servers": {
    "ripio": {
      "command": "npx",
      "args": ["-y", "ripio-community-mcp"],
      "env": { "RIPIO_API_KEY": "your-key", "RIPIO_API_SECRET": "your-secret" }
    }
  }
}

任何其他 MCP 客户端（Cline、Continue…）：添加一个 stdio 服务，命令为 npx，参数为 -y ripio-community-mcp，并设置以下环境变量。有关配置位置，请参阅客户端的 MCP 文档。它也列在官方 MCP Registry 中，名称为 io.github.ruizemanuel/ripio-community-mcp，因此通过 Registry 安装的客户端可以在那里找到它。

**Windows：**如果服务无法启动（例如，出现“Connection closed”），请通过 cmd 启动 npx。在 Claude Code 中，命令末尾加上 -- cmd /c npx -y ripio-community-mcp；在 JSON 配置中，使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "ripio-community-mcp"]。

配置

变量	必需	描述
RIPIO_API_KEY	是	你的 Ripio API 密钥
RIPIO_API_SECRET	是	你的 Ripio 密钥
RIPIO_TRADE_RPS	否	Ripio Trade 每秒请求数。默认值为 1；如果账户已验证相关文件，最高可设为 3.5

安全模型

• 从设计上仅支持读取。 HTTP 客户端只能发送 GET 请求；如果代码中出现其他请求，测试会导致构建失败。即使密钥拥有写入权限，也无法通过此服务转移资金。
• 仅连接一个主机。 它只与 https://api.ripio.com 通信，且不会跟随重定向，因此签名请求不会被发送到其他位置。无遥测数据。
• 密钥由你掌控。 密钥从环境变量（或 Claude Desktop 中的密钥链）读取，不会被记录日志，也不会发送给模型。
• 最小权限。 使用带 IP 允许列表的“只读”密钥。你可以随时在 Ripio → Profile → API 中撤销该密钥。
• 构建可验证。 npm 版本由 GitHub Actions 发布，并附有来源证明。

发现漏洞？请参阅 SECURITY.md。

限制

• Ripio 的 API 不提供卡片交易、应用内买卖或账单支付数据。自 2026-07-21 起，这些数据不会显示在活动记录中。
• 对于 Wallet 活动，from/to 用于筛选 Ripio 返回的页面；如需查看更早的项目，请继续使用 next_cursor。当页面数据的时间范围早于 from 时，不会再提供 next_cursor。
• 数值是按 Ripio 应用的卖出汇率计算的估值，并非确定报价。
• 已使用阿根廷账户进行测试。其他国家的账户可能支持读取，但尚未经过测试。
• 未验证相关文件时，Ripio Trade 每秒仅允许 1 个请求；服务会为你控制请求频率。
• Ripio Trade 对账单每次最多可读取 182 天的数据；如需更早的记录，请按约 6 个月为一个区间分批查询。
• 充值地址是 Ripio 应用（Wallet）地址。目前尚不支持 Ripio Trade 充值地址。

开发

npm ci
npm test
npm run build

如需使用自己的账户运行实时测试套件，请创建 .env.live（已加入 Git 忽略），并在其中填写只读密钥的 RIPIO_API_KEY 和 RIPIO_API_SECRET，然后运行 npm run test:live。

欢迎贡献。请保持服务为只读，并为每项更改添加测试。

免责声明

本项目采用 MIT 许可。本项目与 Ripio 无关，未获其认可或支持；商标归其所有者所有。本项目展示的所有内容仅供参考，不构成财务建议。您需自行负责 API 密钥的安全。