bitget-agent-mcp — 官方 Bitget MCP 交易服务器

通过"模型上下文协议"将克洛德桌面,光标,续作,Windsurf & ChatGPT连接到Bitget——用自然语言进行密码交易.

快速启动 • 妇女 能力 • 妇女 如何运作 • 妇女 安装 • 妇女 配置 • 妇女 警卫 • 妇女 解决问题 • 妇女 财务问题

概览

bitget-agent-mcp 这是 官方模式上下文协议服务器 对 Bitget 来说, 允许桌面 AI 代理像 克劳德桌面, (中文(简体) ), 光标, (中文(简体) ), 继续, (中文(简体) ), 风起浪起,以及 聊天GPT 桌面 通过自然语言命令运行您的 Bitget 账户.

这是建立在 Bitget 统一交易账户( UTA / v3) API 覆盖 89个交易业务 跨市场数据、现货、期货、账户和基金管理、分账户、贷款和税收。 关键是确实如此 没有 用每个终点一个工具淹没你的模型。 相反,它暴露了一个小, 逐步发现意图表面 联 合 国 14个主动词 (默认配置装入了12个动词 +) discover + 键 raw =14个工具),所以AI主机获得全能,没有上下文bloat和工具选择错误来困扰端点-每个工具服务器.

部分 位元代理 Hub ——Bitget的官方开源AI生态系统,包括CLI,SDK,安装器,以及市场分析技能.

快速启动

先决条件

• 节点.js 20 (单位:千美元)下载(中文(简体) )
• Bitget API 密钥 (单位:千美元)在此创建——启用 读取 + 键 贸易 权限
• 一个 MCP 有能力的 AI 主机( Claude 桌面、 光标、 继续、 Windsurf、 ChatGPT 桌面或任何 stdio MCP 客户端)

单步安装( 建议)

将此提示粘入您的 AI 代理( Claude Desktop / cursor /等) :

Please configure the Bitget MCP Server for my AI tool (requires Node.js 20+):
first ask me which AI tool I use (Claude Desktop / Cursor / Windsurf / ChatGPT
Desktop), then add a server that runs `npx -y @bitget-ai/bitget-agent-mcp` to
that tool's MCP config, with BITGET_API_KEY, BITGET_SECRET_KEY, and
BITGET_PASSPHRASE filled in. Confirm once the Bitget tools have loaded.

特工会发现你的工具,加上 npx 服务器输入,连接证书,并验证连接.

手动安装

喜欢自己编辑配置文件吗 ? 跳转到 配置 jSON的片断 命令总是:

npx -y @bitget-ai/bitget-agent-mcp

你能做什么吗

一旦配置了,你的人工智能就可以通过自然语言获得Bitget的交易堆栈的本地访问权. 几个例子(每个地图都显示在表面的真实操作):

市场数据 market 动词)是 公开 并且没有 API 证书; 任何触及您的账户都需要密钥.

高级模式

• --read-only – 屏蔽每次会话的写入操作. 动词保持可见,但任何命令,转移,取消,或撤回在到达Bitget之前都会被拒绝. 安全探索的理想。 (与 --paper-trading. ) (中文(简体) )
• --paper-trading - 路由签名请求到Bitget 民主贸易 环境(加上 paptrading: 1 头曰. 需要单独的 Demo API 密钥完美地排练无风险战略.
• --modules <list> ——只装入需要的模块. 默认 : account,trade,market。点播: strategy, (中文(简体) ), cryptoloans, (中文(简体) ), tax。 。 。 .
• --surface <intent|full> —— 说 intent (默认)会暴露出被曲解的动词. full 另外每个下方的 v3 端点输出一个工具.

一个特工如何使用它

意图表面是 逐步发现而不是看前面的每一个计划, 代理跟踪 发现 – 钻出 – 执行数字 :

discover({})                                   → list business domains + meta-tools
discover({ domain: "trade" })                  → that domain's verbs, one line each
discover({ tool: "order" })                    → one verb's full input schema (+ its actions)
discover({ tool: "order", action: "place" })   → one action's exact required/optional contract
order({ action: "place", ... })                → execute

如果提示已经暗示了动词和参数,代理人跳过发现并直接拨打. discover({ search: "funding" }) 关键词在域不明时搜索整个地表. 两个元工具始终存在:

• discover ——逐步进行地表回溯.
• raw - 一个逃生舱门,可以到达任何v3操作 operationId 为长尾. (实际上,每个操作都由动词所涵盖,所以) raw 很少需要这种服务。 )

写作安全

• 普通写作立即执行 .
• 高风险/不可逆转的行动 (例如:. cancelAll, (中文(简体) ), withdraw返回时 { confirmationRequired: true } 除非你通过 confirm: true。 。 。 .
• 任何笔迹 接受 dryRun: true 预览将发送请求而不发送.

MCP工具说明来自SDK的 riskLevel (read / write / high),因此主机可以在模型引用前标出破坏性操作.

建筑

graph TD
    A[AI Host<br/>Claude Desktop / Cursor / …] -->|MCP over stdio| B[bitget-agent-mcp<br/>thin protocol adapter]
    B --> S[@bitget-ai/bitget-agent-sdk<br/>intent verbs · discover · raw<br/>write-safety gate · HMAC signing · retry]
    S -->|HMAC-SHA256 signed| C[Bitget UTA v3 REST API<br/>api.bitget.com]
    D[Environment Variables<br/>BITGET_API_KEY etc.] --> B
    style B fill:#f9f,stroke:#333,stroke-width:2px
    style C fill:#bbf,stroke:#333,stroke-width:2px

如何运作:

1. 您的 AI 主机在本地通过 npx 过stdio——没有网络听众,没有代理.
2. 证书作为环境变量从您主机的配置中传递;服务器从不存储,日志,或代理它们.
3. 所有经认证的请求均由HMAC-SHA256在过程中签名,并直接发送到Bitget的官方API.
4. 通过MCP回馈到你的AI对话.

所有"智能"——发现,意图路线,写作安全门,签名,以及反应塑造——活在 @bitget-ai/bitget-agent-sdk。这个包是上面一个很薄的自适应器.

安装

支持的AI主机

分步设置

1. 获取您的 API 密钥

1. 登录到 bitget.com (中文(简体) )
2. 转到 概况-API管理
3. 点击 创建 API 密钥
4. 启用 读取 财务报告和审定财务报表 贸易 权限
5. 复制三个值 : API Key, (中文(简体) ), Secret Key, (中文(简体) ), Passphrase

⚠️ 安全说明: 安全存储这些。 永远不要分享它们或承诺它们进行版本控制.

2. 配置您的主机

使用 单步提示,或手动将服务器添加到主机的 MCP 配置(参见 配置) (中文(简体) ).

3. 核实

问你的AI: "有什么比特工具可用吗?" 你应该看看动词 market, (中文(简体) ), order, (中文(简体) ), position, (中文(简体) ), account_overview附加时 discover 财务报告和审定财务报表 raw。 。 。 .

配置

克劳德桌面

编辑 claude_desktop_config.json数字 :

• 马可斯: ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗口 : %APPDATA%\Claude\claude_desktop_config.json
• 林纳: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bitget": {
      "command": "npx",
      "args": ["-y", "@bitget-ai/bitget-agent-mcp"],
      "env": {
        "BITGET_API_KEY": "your-api-key-here",
        "BITGET_SECRET_KEY": "your-secret-key-here",
        "BITGET_PASSPHRASE": "your-passphrase-here"
      }
    }
  }
}

保存后重新启动 Claude 桌面 .

光标

设置 — MCP — 添加新服务器 :

⚠️ 光标工具限制 : 光标封顶, 总的 MCP 工具在 第40条 横跨所有服务器。 默认的 Bitget 配置文件负载 14个工具 (12个意图动词+) discover + 键 raw),为其他服务器留有26个插槽. --modules all 产量 16个工具。 。 。 .

继续 / Windsurf / ChatGPT 桌面 / 其他 MCP 主机

用同样的 npx -y @bitget-ai/bitget-agent-mcp 命令和通过环境变量传递证书,遵循您工具的 MCP 配置文件。 如果主机会说MCP优于stdio,那就奏效了.

自定义配置示例

只读模式( 勘探安全 ) :

{ "args": ["-y", "@bitget-ai/bitget-agent-mcp", "--read-only"] }

纸张交易(Demo Environment-使用Demo API键):

{
  "args": ["-y", "@bitget-ai/bitget-agent-mcp", "--paper-trading"],
  "env": {
    "BITGET_API_KEY": "your-demo-api-key",
    "BITGET_SECRET_KEY": "your-demo-secret-key",
    "BITGET_PASSPHRASE": "your-demo-passphrase"
  }
}

装入额外模块 :

{ "args": ["-y", "@bitget-ai/bitget-agent-mcp", "--modules", "account,trade,market,cryptoloans,tax"] }

CLI 选项和环境变量

bitget-agent-mcp [options]

  --modules <list>     account, trade, market, strategy,
                       cryptoloans, tax
                       "all" loads every module.
                       Default: account,trade,market

  --surface <mode>     intent  curated verbs + discover + raw (default)
                       full    ALSO emit one tool per underlying v3 endpoint

  --read-only          Expose only read/query operations; block all writes.
  --paper-trading      Enable Demo Trading mode (requires a Demo API Key).
                       Mutually exclusive with --read-only.
  --help               Show help and exit
  --version            Show version and exit

没有API证书,只有公共/读取(市场数据)操作成功.

模块和有意动词

默认配置文件加载 account,trade,market。整个套期 6个单元 财务报告和审定财务报表 14个主动词数字 :

无论模块, 总是显示 : discover (参)并 raw (通过 operationId) (中文(简体) ).

警卫

证书保护

• ✅ 永远不要离开你的机器 ——API密钥仅从环境变量读取,从未登录,被写入磁盘,或通过任何服务器代理.
• ✅ 本地签名 ——所有经认证的请求在直接连接到Bitget的官方API之前,都会在过程中与HMAC-SHA256签名.
• ✅ 本地运行于 stdio ——不设网络收听器,不设远程端点来硬化,不设遥测.

安全模式

• --read-only ——为会话屏蔽所有写入操作;AI可以查询但不能下订单,转移资金,取消,或取出.
• --paper-trading ——线路向Bitget的Demo环境签名请求. 没有涉及真正的资金。 需要单独的 Demo API 密钥 .
• 写作安全门 高风险/不可逆转的行动需要明确 confirm: true,以及任何文字支持 dryRun: true 用于无网络预览.

限制费率

SDK采用客户端重试/速率限制政策,防止AI回路锤击Bitget的API. 如果比特返回一个 429自动复试.

解决问题

"没有找到命令: npx"

原因 : 节点.js没有安装或不安装在PATH上. 修补 : 安装节点.js 20 from 节点js.org 并重新启动您的终端/主机.

"认证失败"或"无效 API 密钥"

可能原因修正( F) :

1. API 密钥缺乏权限 启用 读取 + 键 贸易 时间 API 管理。 。 。 .
2. 密码句错误 – 完全复制显示的所有三个值 .
3. 使用的活键 --paper-trading (反之亦然) 使用a Demo API 密钥 用于造纸交易.

"不为AI所识别"

原因 : MCP 服务器配置不正确, 或者主机没有重新启动 . 修补 : 验证配置文件是有效的 JSON, 完全重新启动主机, 然后询问 "列出可用的MCP工具"

光标显示比预期的比特工具少

原因 : 其他MCP服务器 消耗 Cursor的40个工具盖。 Bitget 默认配置文件是 14个工具。 。 。 . 修补 : 删除未使用的 MCP 服务器,或使用 --modules 只能装上你需要的东西.

"超过极限"

原因 : 太多的快速电话. 修补 : sDK自动机,但如果击中了Bitget的服务器侧限,则在重试前等待~60s. 避免要求AI迅速接连下达上百个订单.

MCP 服务器不会启动

检查 : 节点.js 版本 (node --version 20),网络可达到 api.bitget.com外出HTTPS没有被防火墙挡住.

更新

因为安装使用 npx -y,在每次您的 AI 主机启动时都会自动拉出最新版本—— 不需要手动更新 .

要强制更新 npm 缓存 :

npx @bitget-ai/bitget-agent-mcp@latest --version

要同时升级整个 Bitget AI 工具包,请使用安装器 代理服务器( h)。 。 。 .

相关项目

财务问题

什么是Bitget -agent -mcp? (英语)?

这是 官方 MCP( 模式上下文协议) 服务器 为比特. 它会暴露 89 位元 UTA v3 操作 到桌面AI客户端(Claude桌面、光标、Windsurf、ChatGPT桌面.) 14个主动词 加一个 discover 反省工具和一个 raw 逃脱舱门——超过MCP标准.

这跟Cli探员有什么不同?

• bitget-agent-mcp 用于 桌面AI 主机 使用 MCP (Claude 桌面, cursor, ...) .
• agent-cli (单位:千美元)bgc)——用于 终端AI (Claude Code, Codex CLI)在你的外壳中运行命令.

两人都坐在同一SDK上,并暴露出相同的意图表面——选择一个与你的AI工具相匹配的.

为什么故意动词而不是每个终点一个工具?

Endpoint-per-tool服务器每个端点广告一个工具,这个工具会膨胀模型的上下文并降低工具选择的精度. 意图表面保留默认工具列表 14个工具 (12个动词+) discover + 键 raw),同时仍然直接涵盖所有89个默认暴露操作——和 raw 到达任何操作 operationId 当你需要长尾巴时 该剂使用 discover 只有在需要的时候 才能详加阐述.

默认装入哪些模块 ?

默认 : account (39项行动), trade (17项行动), market (16项行动)= 72次行动,通过 12个意图动词 加号 discover 财务报告和审定财务报表 raw (单位:千美元)14个工具 (共计) 装入更多 --modules strategy,cryptoloans,tax 或者说 --modules all (通过89个终点达到14个动词).

Cursor有工具限制吗?

是 — 光标封顶, 总的 MCP 工具在 第40条。默认的比特配置文件负载 14个工具,在盖子内(空出26个槽). --modules all 产量 16个工具。 。 。 .

我该如何防止意外命令?

添加 "--read-only" 到您的配置参数。 每个会话的写作操作都被拒绝——AI可以查询余额和市场,但不能下订单,转移资金,取消,或取出.

我能不冒着资金的风险去测试吗?

是——使用纸张交易:建立 Demo API 密钥,将Demo证书设定为环境变量,并添加 "--paper-trading" 以你的标语。 已签名请求前往 Bitget 的 Demo 环境 .

我的API钥匙安全吗?

对 身份证明只存在于您主机的MCP配置中,从未通过任何服务器代理,在到达比特之前在当地与HMAC-SHA256签名,也从未被此服务器登录或写入磁盘.

免费吗?

是的,麻省理工学院有许可证,可免费用于个人和商业用途。 MCP服务器由Bitget免费维护.

支持什么人工智能工具?

Claude Desktop, Cursor, Creep, ChatGPT 桌面, Windsurf, 以及任何通过 stdio 传输进行通信的MCP客户端.

捐款

欢迎提出问题和拉动请求.

• 报告错误/ 请求特性 : GitHub 问题
• 安全问题: 请通过 GitHub 的安全咨询功能私下报告 仓库 ——不公开问题.

许可证

MIT 许可证 ——个人和商业用途免费.

_{⚠️ 风险免责声明: 交易密码货币的风险很大。 你只负责命令你的人工智能特工 代表你。 使用 --read-only 财务报告和审定财务报表 --paper-trading 在直播前安全排练 过去的业绩不能保证未来的结果.}

_{官方 Bitget Agent Hub 工具 · 部分 Bitget 开源 AI 生态系统 · 基金会 : 代理服务器 其他地表: 代理目录 • 妇女 代理技能 市场信号: 位元符号}