mcpField
M
mcp-mercado-bitcoin

mcp-mercado-bitcoin

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-mercado-bitcoin

mcp-mercado-bitcoin 是巴西加密货币交易所 Mercado Bitcoin 的 MCP 服务。它面向需要查询行情、下单和管理账户的开发者与 Agent，通过 MCP 客户端访问交易、订单簿和提现等功能。

主要功能

  1. 01行情与 K 线数据查询
  2. 02订单簿与成交记录查询
  3. 03下单、撤单与订单查询
  4. 04账户余额与交易记录
  5. 05充值与提现记录管理
  6. 06交易手续费查询

适用场景

  1. 01在 AI 助手中查询交易对的行情与订单簿
  2. 02批量撤销未成交订单
  3. 03核对账户的充值与提现记录

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 20 个工具，覆盖行情、交易、账户和提现等操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-mercado-bitcoin": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-mercado-bitcoin"
      ],
      "env": {
        "MB_API_KEY": "<MB_API_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-mercado-bitcoin
需要配置的环境变量
MB_API_KEY密钥API key for mercado-bitcoin

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-mercado-bitcoin0.2.2

工具

20

收录的工具列表 · 更新于 2 周前

参数类型必填说明
symbolstring是交易对符号（例如 BTC-BRL、ETH-BRL、USDC-BRL）

详细介绍

@codespar/mcp-mercado-bitcoin

面向 Mercado Bitcoin 的 MCP 服务——巴西加密货币交易所，提供交易、订单和市场数据

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "mercado-bitcoin": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-mercado-bitcoin"],
      "env": {
        "MB_API_KEY": "your-key",
        "MB_API_SECRET": "your-secret"
      }
    }
  }
}
Claude Code
claude mcp add mercado-bitcoin -- npx @codespar/mcp-mercado-bitcoin
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "mercado-bitcoin": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-mercado-bitcoin"],
      "env": {
        "MB_API_KEY": "your-key",
        "MB_API_SECRET": "your-secret"
      }
    }
  }
}

工具（20 个）

工具用途
get_ticker获取交易对的行情数据（价格、成交量等）
list_orderbook获取交易对的订单簿（买单和卖单）
create_order创建买入或卖出订单
get_order按 ID 获取订单详情
cancel_order取消未完成的订单
list_orders列出订单，可选使用筛选条件
get_balance获取账户所有资产的余额
list_trades列出交易对的已执行交易
get_candles获取交易对的 K 线 / OHLCV 数据
withdraw创建提现请求
cancel_all_orders取消某个交易品种的所有未完成订单
list_account_trades列出已认证账户某个交易品种的成交记录 / 交易
list_deposits列出已认证账户的充值记录（加密货币 + 法币）
list_withdrawals列出已认证账户的提现记录（加密货币 + 法币）
get_withdrawal按 ID 获取提现详情
list_symbols列出交易所提供的交易品种（交易对）
list_assets列出交易所支持的资产 / 代币
list_networks列出指定资产支持的区块链网络
get_fees查询某个交易品种的交易手续费（挂单方 / 吃单方）
list_positions列出未平仓的保证金 / 期货仓位（若账户适用）

身份验证

Mercado Bitcoin 使用通过请求标头传递的 API 密钥和密钥。

沙盒 / 测试

Mercado Bitcoin 提供可通过控制面板访问的沙盒，用于测试。

获取凭据
  1. 前往 Mercado Bitcoin
  2. 创建账户
  3. 前往 API 设置，生成密钥和密钥
  4. 设置环境变量

环境变量

变量必需描述
MB_API_KEY是Mercado Bitcoin 的 API 密钥
MB_API_SECRET是Mercado Bitcoin 的 API 密钥

路线图

v0.2（计划中）
  • get_account_info — 获取账户信息和限额
  • list_currencies — 列出可用的加密货币
  • get_order_history — 按筛选条件获取订单历史记录
  • create_stop_order — 创建止损限价订单
  • get_fees — 获取账户的交易手续费
v0.3（计划中）
  • margin_trading — 保证金交易操作
  • lending — 加密货币借贷操作

想要参与贡献？提交 PR，或申请工具。

链接

企业版

需要为 Agent 付款提供治理、预算限额和审计追踪？CodeSpar Enterprise 在这些 MCP 服务之上增加策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。