mcpField
B
Bitget Mcp Server

Bitget Mcp Server

本地服务
github.com/BitgetLimitedAI 与智能体23317 周前更新

关于 Bitget Mcp Server

Bitget Agent Hub 是 Bitget 官方发布的开源 AI Agent 工具集,可让 Claude、Cursor 等 AI 客户端访问 Bitget 账户与市场数据。它面向交易者与量化开发者,并区分需要 API Key 的交易工具和无需账户的市场分析工具。

主要功能

  1. 0189 项 UTA v3 操作,通过意图动词调用
  2. 02终端 AI 用 bgc 命令行工具与技能
  3. 03桌面 AI 通过 MCP 服务接入
  4. 04只读与模拟盘模式防止误操作
  5. 05无需账户的市场分析技能

适用场景

  1. 01让 AI 助手通过自然语言查询余额与下单
  2. 02在模拟盘中测试交易指令
  3. 03使用无需 API Key 的技能分析宏观与链上数据

MCP 相关

bitget-agent-mcp 是面向 Claude Desktop、Cursor 等桌面客户端的 MCP 服务,bitget-signal 提供公共的无密钥市场数据 MCP 服务。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"agent_hub": {
"command": "npx",
"args": [
"-y",
"bitget-mcp-server"
],
"env": {
"BITGET_API_KEY": "<BITGET_API_KEY>",
"BITGET_SECRET_KEY": "<BITGET_SECRET_KEY>",
"BITGET_PASSPHRASE": "<BITGET_PASSPHRASE>"
}
}
}
}
启动命令npx -y bitget-mcp-server
需要配置的环境变量
BITGET_API_KEY密钥
BITGET_SECRET_KEY密钥
BITGET_PASSPHRASE

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

安装包
npmbitget-mcp-server

工具

36

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

参数类型必填说明
symbolstring否交易对符号,例如 BTCUSDT。省略则获取所有行情。

详细介绍

Bitget Agent Hub - 面向 Claude、Cursor、Codex、ChatGPT 的 Bitget 官方 AI 交易与市场数据生态系统

Bitget Agent Hub — Bitget 官方 AI 交易与市场数据生态系统

官方开源工具包,可将 Claude、Cursor、Codex、ChatGPT 及任何兼容 MCP 的 AI Agent 连接到你的 Bitget 账户和市场数据。

Bitget Agent SDK npm 版本 - 基础 TypeScript 库 Model Context Protocol MCP 兼容 AI 集成标准 需要 Node.js 20 或更高版本的运行环境 MIT 开源许可证 - 可免费用于商业用途

快速开始 · 生态系统 · 安装程序 · 交易工具 · 市场工具 · 架构 · 安全 · 常见问题


概述

Bitget Agent Hub 是 Bitget 官方的 AI Agent 工具包,涵盖加密货币和代币化美股交易,可将 89 项 Bitget UTA v3 交易与市场分析操作带给 Claude、Cursor、Codex、ChatGPT 及其他 AI Agent。

专为个人交易者、量化开发者,以及任何希望通过自然语言操作加密货币交易所的人打造。

此代码库是整个生态系统的中央入口。详细文档请参阅各个软件包的代码库。


快速开始

你想做什么?
What do you want to do with AI?
|
+-- Let an AI Agent trade on Bitget for me
|     |
|     +-- Terminal AI (Claude Code / Codex CLI / OpenClaw)
|     |   -> install agent-cli + agent-skill
|     |
|     +-- Desktop AI (Claude Desktop / Cursor / Continue)
|         -> install agent-mcp
|
+-- Let an AI Agent monitor and analyze the market for me
|     -> install bitget-signal (no account, no API key)
|
+-- I'm a developer building my own Bitget AI tool
      -> install bitget-agent-sdk
使用你的 AI 安装

上面的用例树会告诉你需要哪个软件包。要一次性设置终端工具,请将以下内容粘贴到你的终端 AI(Claude Code、Codex、OpenClaw)中:

Please run `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` to set up the Bitget Agent Hub terminal tools (requires Node.js 20+), then help me verify the install.

此操作会安装 bgc CLI、交易和市场信号技能,并将这些技能部署到 Claude Code、Codex 和 OpenClaw。桌面 AI(Cursor、Claude Desktop、ChatGPT)使用 bitget-agent-mcp,详见交易工具。各软件包的命令、回滚方法和标志详见下方的安装程序。


生态系统

Bitget Agent Hub 由 5 个核心软件包组成,每个软件包各司其职。此代码库还提供 bitget-agent-installer 元工具,可一并安装和升级这些软件包。

交易工具(需要 API 密钥)
软件包适用对象功能
bitget-agent-sdk开发者基础 TypeScript SDK,提供 89 项 UTA v3 操作
bitget-agent-cli终端 AI为 Claude Code、Codex、OpenClaw 提供 bgc 命令行工具
bitget-agent-mcp桌面 AI为 Claude Desktop、Cursor、Windsurf、ChatGPT 提供 MCP 服务
bitget-agent-skill终端 AIAI 推理指南,教你如何正确使用 bgc
市场工具(无需账户)
软件包功能
bitget-signal5 项市场分析技能 — 宏观、链上、情绪、技术、新闻

所有软件包均采用 MIT 许可证,可免费使用。它们可以并行安装,互不冲突。

安装器

@bitget-ai/bitget-agent-installer 是整个生态系统的元工具。只需一条命令,即可将 Bitget Agent Hub 软件包安装、升级、回滚并部署到你的 AI 工具中,无需逐个安装软件包,也无需手动运行每个技能的设置流程。

npx @bitget-ai/bitget-agent-installer

不带参数运行即可打开交互式菜单,也可以直接传入命令(见下文)。

管理内容
软件包作用
bitget-agent-cli终端交易 CLI bgc
bitget-agent-skill面向终端 AI 的交易推理指南
bitget-signal市场分析技能(无需 API 密钥)

桌面 AI 使用 bitget-agent-mcp,需在 MCP 客户端的配置中注册,而不是全局安装——请直接通过 MCP 软件包进行设置。bitget-agent-sdk 是库依赖,无需单独安装。

使用理由
  • 一条命令管理整个生态系统 — 一起安装、升级或回滚所有软件包。
  • 始终保持最新 — 自动获取每个软件包最新发布的版本;无需固定版本,不同软件包使用不同版本也能正常工作。
  • 内置技能部署 — 通过 --target 将技能直接接入 Claude Code、Codex 和 OpenClaw。
  • 可逆操作 — 将任何软件包回滚到此前发布的版本。
  • 可安全预览 — --dry-run 会打印所有命令,但不会执行。
  • 轻量 — 通过 npx 运行单个无依赖脚本;自动检测 npm 或 pnpm。
命令
命令功能
(无参数)交互式菜单 — 升级、回滚或部署技能
upgrade-all [--target <tools>]将所有受管理的软件包安装或更新到最新版本
upgrade <pkg> [--target <tools>]将一个软件包安装或更新到最新版本
rollback <pkg> --to <version>将软件包切换到指定的已发布版本
install [pkg] [--target <tools>]将已安装软件包的技能部署到你的 AI 工具

标志

  • --target <tools> — 技能部署目标:claude、codex、openclaw、all(逗号分隔;默认值为 claude)
  • --dry-run — 预览命令但不执行
  • --version · --help
示例
# Install everything and deploy skills to every supported AI tool
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Update just the CLI to the latest version
npx @bitget-ai/bitget-agent-installer upgrade @bitget-ai/bitget-agent-cli

# Roll the CLI back to the pre-v3 release
npx @bitget-ai/bitget-agent-installer rollback @bitget-ai/bitget-agent-cli --to 1.2.0

# Deploy already-installed market-signal skills into Claude Code and Codex
npx @bitget-ai/bitget-agent-installer install @bitget-ai/bitget-signal --target claude,codex

# Preview an upgrade without changing anything
npx @bitget-ai/bitget-agent-installer upgrade-all --target all --dry-run

交易工具

让 AI Agent 自动为你交易 Bitget

Bitget Agent Hub 的交易工具通过 14 个精心设计的意图动词提供 89 项 UTA v3 操作:

向 AI 提问功能
“以市价买入 0.1 BTC”现货市价单
“开一个 BTC 多头仓位,10 倍杠杆”期货仓位
“查看我的余额”账户概览
“将 USDT 转到期货账户”内部资金划转
“取消所有未完成订单”批量撤单
选择你的 AI 环境
AI 所在环境…已安装的软件包
终端 AI:Claude Code、Codex CLI、OpenClawbitget-agent-cli + bitget-agent-skill
桌面 AI:Claude Desktop、Cursor、Continue、Windsurf、ChatGPT Desktopbitget-agent-mcp
开始使用
  1. 在 bitget.com/api-management 创建 Bitget API 密钥
  2. 运行安装器向导或参阅各软件包的文档
  3. 向你的 AI 提问 “有哪些 Bitget 工具可用?”,以验证安装

首次使用?请创建一个演示 API 密钥,并使用 --paper-trading 进行练习,再操作真实资金。


市场工具

让 AI Agent 实时监控和分析市场

bitget-signal 添加了 5 项市场分析技能——无需 Bitget 账户,也无需 API 密钥:

向 AI 提问技能
“美联储政策如何影响 BTC?”macro-analyst
“巨鲸正在链上转移资产吗?”market-intel
“市场情绪是恐惧还是贪婪?”sentiment-analyst
“BTC 的 RSI 是否已超买?”technical-analysis
“今天加密货币领域有哪些重要消息?”news-briefing
开始使用
npx @bitget-ai/bitget-signal --target all

重启你的 AI 工具,然后询问市场状况。

即将推出

Bitget 独家信号:

  • top-trader-flow:顶级跟单交易员持仓情况
  • derivatives-structure:永续合约基差和期限结构
  • large-flow-detect:鲸鱼级别订单检测

架构

graph TD
    subgraph Surfaces
        A[bitget-agent-cli<br/>Terminal AI]
        B[bitget-agent-mcp<br/>Desktop AI MCP]
        C[bitget-agent-skill<br/>AI Reasoning Guide]
    end
    
    subgraph Foundation
        D[bitget-agent-sdk<br/>TypeScript SDK]
    end
    
    subgraph MarketAnalysis
        E[bitget-signal<br/>5 Analysis Skills]
    end
    
    A --> D
    B --> D
    C --> A
    D --> F[Bitget UTA v3 API]
    E --> G[Public Market-Data MCP<br/>no API key]
    
    style D fill:#f9f,stroke:#333,stroke-width:2px
    style F fill:#bbf,stroke:#333,stroke-width:2px

工作原理:

  1. SDK(bitget-agent-sdk):基础层,提供 89 项操作、HMAC 签名和速率限制
  2. CLI(bitget-agent-cli):基于 SDK 构建的终端命令行工具
  3. MCP(bitget-agent-mcp):基于 SDK 构建的桌面 AI 服务
  4. Skill(bitget-agent-skill):教会终端 AI 如何正确使用 CLI
  5. Signal(bitget-signal):通过公开、无需密钥的市场数据 MCP 服务进行独立市场分析

支持的操作

基于 Bitget UTA v3 API,通过 14 个精选意图动词提供 89 项操作:

模块默认启用意图动词需要 API 密钥
market✅market否(公开数据)
trade✅order、position、strategy_order是
account✅account_overview、transfer_funds、…是
strategy—通过 raw是
cryptoloans—loan是
tax—tax是

strategy_order 由 trade 模块控制——下达策略订单属于交易能力,只要启用了交易,Agent 就会期待具备这项能力;strategy 模块的其他操作仍可通过 raw 使用。

此外还有元工具:discover(探索操作)和 raw(通过 operationId 调用任意操作)。

随时使用 bgc discover(或在任何界面中使用 discover)浏览实时目录。


安全性

凭据保护
  • ✅ 绝不会离开你的设备:API 密钥仅从环境变量中读取
  • ✅ 本地签名:所有经过身份验证的请求都在进程内使用 HMAC-SHA256 签名
  • ✅ 不解析 .env:工具不会读取 .env 文件,以防止凭据泄漏
  • ✅ 不使用代理:直接连接 Bitget 官方 API
安全模式
  • --read-only:启动时移除所有写入工具——AI 无法下单或转账
  • --paper-trading:请求路由至 Bitget 的 Demo 环境——不涉及真实资金
  • 速率限制:内置客户端限流机制,防止 API 滥用
最佳实践
  1. 首先使用 Demo API Key 进行测试
  2. 先以 --read-only 模式启动,验证查询
  3. 切勿将凭据提交到版本控制系统
  4. 每 90 天轮换一次 API 密钥

文档

主题文档
入门指南docs/getting-started.md
生态系统架构docs/architecture.md

各软件包的参考文档——CLI 标志、MCP 客户端配置、SDK API、信号技能——位于各自的软件包仓库中(参见上方的生态系统表格)。始终可以使用 bgc discover(或在任何界面中使用 discover)浏览实时工具界面。


链接


常见问题

什么是 Bitget Agent Hub?

Bitget Agent Hub 是 Bitget 官方开源 AI Agent 生态系统。它将 Bitget 的加密货币交易能力和实时市场数据接入 Claude、Cursor、Codex 和 ChatGPT 等 AI Agent,涵盖通过 14 个精选意图动词提供的 89 项 UTA v3 操作,以及无需账户的市场分析技能。

如何确定要安装哪个软件包?

这取决于你使用的 AI 工具:

  • 终端 AI(Claude Code、Codex)→ bitget-agent-cli + bitget-agent-skill
  • 桌面 AI(Claude Desktop、Cursor)→ bitget-agent-mcp
  • 仅需市场分析 → bitget-signal(无需 API 密钥)
  • 开发自定义工具 → bitget-agent-sdk
我可以使用 AI 自动交易加密货币吗?

可以。安装后,你可以让支持的 AI 工具“买入 0.1 BTC”或“以 10 倍杠杆开立 BTC 多头仓位”,AI 就会直接在你的 Bitget 账户中执行。使用 --paper-trading 模式安全地进行演练。

连接我的 API 密钥安全吗?

安全。凭据:

  • 仅从环境变量读取
  • 从不通过任何服务器代理
  • 在本地使用 HMAC-SHA256 签名
  • 从不记录日志或写入磁盘
如何防止意外下单?

启动时添加 --read-only。所有写入工具都会被完全移除——AI 无法看到或调用它们。

支持哪些 AI 工具?

Claude Desktop、Claude Code、Cursor、Codex CLI、Continue、Windsurf、ChatGPT Desktop、OpenClaw,以及任何兼容 MCP 的客户端。

免费吗?

所有软件包均采用 MIT 许可,可免费使用。bitget-signal 由 Bitget 维护,可免费使用——无需 API 密钥或账户。

如何更新所有内容?

运行 npx @bitget-ai/bitget-agent-installer 并选择升级,或者:

npx @bitget-ai/bitget-agent-installer upgrade-all --target all

贡献

欢迎提交问题和拉取请求。


许可证

MIT License — 可免费用于个人和商业用途。欢迎注明出处,但并非必须。


⚠️ 风险免责声明:交易加密货币和代币化股票存在重大风险。对于 AI Agent 代表你下达的任何订单,责任完全由你承担。上线实盘前,请务必使用 --read-only 和 --paper-trading 模式安全地进行演练。

Bitget Agent Hub 是 Bitget 官方开源项目 · 属于 Bitget AI 生态系统 · 为交易者、开发者和 AI 爱好者打造

评论

支持 Markdown

第一次接触 MCP?

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

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