# @bitget-ai/bitget-agent-mcp 中文文档

规范地址：https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/

版本：3\.3\.1
npm 元数据更新时间：2026-09-20T05:55:57.648Z
中文译文更新时间：2026-11-08T05:05:14.146Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bitget-ai/bitget-agent-mcp
原文对照：https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/?lang=original
项目主页：https://github.com/Bitget-AI/agent-mcp#readme
源码仓库：https://github.com/Bitget-AI/agent-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：68.9 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：2 个
- 首次发布：2026-06-15T07:10:04.339Z
- 最新版本发布：2026-09-20T05:55:57.461Z
- 近 30 天下载量：2330（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

统一交易账户的官方Bitget MCP服务器(UTA / v3) API——将一个被整理,逐步发现的意图表面(账号,交易,市场,策略,.)暴露给任何MCP相容的AI主机(Claude Desktop, Cursor, Cursor, Continual,.

## 安装

```sh
npm install @bitget-ai/bitget-agent-mcp
```

也可以使用：`pnpm add @bitget-ai/bitget-agent-mcp`、`yarn add @bitget-ai/bitget-agent-mcp`、`bun add @bitget-ai/bitget-agent-mcp`

## README

![Bitget Agent MCP - Official Bitget Crypto Trading MCP Server for Claude Desktop Cursor Windsurf ChatGPT](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/assets/logo.png)

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

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

[![Bitget Agent MCP continuous integration build status](https://github.com/Bitget-AI/agent-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Bitget-AI/agent-mcp/actions/workflows/ci.yml) [![Bitget Agent MCP npm package version - latest release on npm registry](https://img.shields.io/npm/v/%40bitget-ai%2Fbitget-agent-mcp.svg?style=flat-square&color=cb3837&label=npm)](https://www.npmjs.com/package/@bitget-ai/bitget-agent-mcp) [![Bitget Agent MCP monthly downloads count from npm](https://img.shields.io/npm/dm/%40bitget-ai%2Fbitget-agent-mcp.svg?style=flat-square&color=026e00&label=downloads)](https://www.npmjs.com/package/@bitget-ai/bitget-agent-mcp) [![Model Context Protocol MCP compatible AI integration standard](https://img.shields.io/badge/MCP-compatible-8A2BE2?style=flat-square)](https://modelcontextprotocol.io/) ![Requires Node.js version 20 or higher runtime environment](https://img.shields.io/badge/Node.js-%E2%89%A520-026e00?style=flat-square) ![Supports macOS Linux Windows operating systems](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square) [![MIT open source license - free for commercial use](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/LICENSE)

[快速启动](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-quick-start) • 妇女 [能力](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-what-you-can-do) • 妇女 [如何运作](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-how-an-agent-uses-it) • 妇女 [安装](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-installation) • 妇女 [配置](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-configuration) • 妇女 [警卫](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-security) • 妇女 [解决问题](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-troubleshooting) • 妇女 [财务问题](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-faq)

* * *

## 概览

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

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

> **部分 [位元代理 Hub](https://github.com/Bitget-AI/agent_hub)** ——Bitget的官方开源AI生态系统,包括CLI,SDK,安装器,以及市场分析技能.

* * *

## 快速启动

### 先决条件

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

### 单步安装( 建议)

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

```text
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` 服务器输入,连接证书,并验证连接.

### 手动安装

喜欢自己编辑配置文件吗 ? 跳转到 [配置](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-configuration) jSON的片断 命令总是:

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

* * *

## 你能做什么吗

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

| 问你的人工智能 | 发生什么事 | 全权证书 |
| --- | --- | --- |
| "目前BTC的价格是多少" | 活计通过 `market` 动词 | 没有 |
| "打开4h BTC蜡烛" | OHLCV / K线历史通过 `market` | 没有 |
| "BTC的潜伏资金利率是多少?" | 供资率 `market` | 没有 |
| "展示我的USDT平衡账户" | 账户概览通过 `account_overview` | 对 |
| "在市场上购买0.1 BTC" | 通过 `order` | 对 |
| "把杠杆设置到10x 并打开一个BTC长" | `account_config` + 键 `order` 编号 : `position` | 对 |
| "听我的公开命令" | `order` (开口) | 对 |
| "将500美元从现货转移到期货" | 通过 `transfer_funds` | 对 |
| "放弃我所有的公开命令" | `order` (Cancelall)——高风险,要求确认 | 对 |
| "借$DT来抵债" | 通过加密贷款 `loan` | 对 |

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

### 高级模式

-   **`--read-only`** – 屏蔽每次会话的写入操作. 动词保持可见,但任何命令,转移,取消,或撤回在到达Bitget之前都会被拒绝. 安全探索的理想。 (与 `--paper-trading`. ) (中文(简体) )
-   **`--paper-trading`** - 路由签名请求到Bitget **民主贸易** 环境(加上 `paptrading: 1` 头曰. 需要单独的 [Demo API 密钥](https://www.bitget.com/en/api-management)完美地排练无风险战略.
-   **`--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),因此主机可以在模型引用前标出破坏性操作.

* * *

## 建筑

```mermaid
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`](https://github.com/Bitget-AI/agent-sdk)。这个包是上面一个很薄的自适应器.

* * *

## 安装

### 支持的AI主机

| AI 主机 | 状态 | 页:1 |
| --- | --- | --- |
| **克劳德桌面** | ✅ | 头等舱,通过 `claude_desktop_config.json` |
| **光标** | ✅ | 默认配置符合有空位的 40 个工具盖 |
| **继续** | ✅ | VS 代码/ JetBrains 扩展 |
| **聊天GPT 桌面** | ✅ | OpenAI 的桌面客户端 |
| **风起浪起** | ✅ | 柯迪姆的 AI IDE |
| **任何 MCP 客户端** | ✅ | 任何能说MCP 超音速 |

### 分步设置

#### 1\. 获取您的 API 密钥

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

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

#### 2\. 配置您的主机

使用 [单步提示](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-one-step-install-recommended),或手动将服务器添加到主机的 MCP 配置(参见 [配置](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/#readme-configuration)) (中文(简体) ).

#### 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`

```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 — 添加新服务器 :**

| 外地 | 数值 |
| --- | --- |
| **命令** | `npx` |
| **参数** | `-y @bitget-ai/bitget-agent-mcp` |
| **信封** | `BITGET_API_KEY`, (中文(简体) ), `BITGET_SECRET_KEY`, (中文(简体) ), `BITGET_PASSPHRASE` |

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

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

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

### 自定义配置示例

**只读模式( 勘探安全 ) :**

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

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

```json
{
  "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"
  }
}
```

**装入额外模块 :**

```json
{ "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
```

| 变量 | 目的 |
| --- | --- |
| `BITGET_API_KEY` | 私人终点需要 |
| `BITGET_SECRET_KEY` | 私人终点需要 |
| `BITGET_PASSPHRASE` | 私人终点需要 |
| `BITGET_API_BASE_URL` | 可选 API 基址( 默认) `https://api.bitget.com`(中文(简体) ) |
| `BITGET_TIMEOUT_MS` | 可选请求超时 ms( 默认) `15000`(中文(简体) ) |
| `BITGET_MAX_RETRIES` | 可选最大传输重试( 默认: SDK 政策) |

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

### 模块和有意动词

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

| 模块 | 默认 | 意向动词 | 业务 |
| --- | --- | --- | :-: |
| `market` | ✅ | `market` | 16个 |
| `trade` | ✅ | `order`, (中文(简体) ), `position`, (中文(简体) ), `strategy_order` | 页:1 |
| `account` | ✅ | `account_overview`, (中文(简体) ), `account_config`, (中文(简体) ), `repayment`, (中文(简体) ), `transfer_funds`, (中文(简体) ), `deposit`, (中文(简体) ), `withdraw`, (中文(简体) ), `funds_records`, (中文(简体) ), `subaccount` | 页:1 |
| `strategy` | 点播 | 扩展 `strategy_order` (计划/TP-SL订单) | 页:1 |
| `cryptoloans` | 点播 | `loan` | 第11个 |
| `tax` | 点播 | `tax` | 1个 |

无论模块, 总是显示 : **`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](https://nodejs.org/) 并重新启动您的终端/主机.

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

**可能原因修正( F) :**

1.  API 密钥缺乏权限 启用 **读取** + 键 **贸易** 时间 [API 管理](https://www.bitget.com/en/api-management)。 。 。 .
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 缓存 :

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

要同时升级整个 Bitget AI 工具包,请使用安装器 [代理服务器( h)](https://github.com/Bitget-AI/agent_hub)。 。 。 .

* * *

## 相关项目

| 软件包 | 目的 | 最好还是 |
| --- | --- | --- |
| **[代理目录](https://github.com/Bitget-AI/agent-cli)** | 终端 AI 交易工具`bgc`(中文(简体) ) | Claude Code, Codex CLI, 壳内特效 |
| **[代理技能](https://github.com/Bitget-AI/agent-skill)** | CLI的AI推理指南 | 教学人员如何使用 `bgc` 正确的 |
| **[代理服务器](https://github.com/Bitget-AI/agent-sdk)** | 类型脚本基础 SDK | 开发者建立自定义集成 |
| **[位元符号](https://github.com/Bitget-AI/bitget-signal)** | 市场分析技能(无 API 键) | 宏观 连锁 情绪 技术 新闻 |
| **[代理服务器( h)](https://github.com/Bitget-AI/agent_hub)** | 中央生态系统入口+安装器 | 所有 Bitget AI 工具概览 |

* * *

## 财务问题

### 什么是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 密钥](https://www.bitget.com/en/api-management),将Demo证书设定为环境变量,并添加 `"--paper-trading"` 以你的标语。 已签名请求前往 Bitget 的 Demo 环境 .

### 我的API钥匙安全吗?

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

### 免费吗?

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

### 支持什么人工智能工具?

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

* * *

## 捐款

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

-   **报告错误/ 请求特性 :** [GitHub 问题](https://github.com/Bitget-AI/agent-mcp/issues)
-   **安全问题:** 请通过 GitHub 的安全咨询功能私下报告 [仓库](https://github.com/Bitget-AI/agent-mcp) ——不公开问题.

* * *

## 许可证

[MIT 许可证](https://npmcn.com/package/%40bitget-ai/bitget-agent-mcp/LICENSE) ——个人和商业用途免费.

* * *

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

官方 Bitget Agent Hub 工具 · 部分 Bitget 开源 AI 生态系统 · 基金会 : [代理服务器](https://github.com/Bitget-AI/agent-sdk) 其他地表: [代理目录](https://github.com/Bitget-AI/agent-cli) • 妇女 [代理技能](https://github.com/Bitget-AI/agent-skill) 市场信号: [位元符号](https://github.com/Bitget-AI/bitget-signal)

## 常见问题

### @bitget-ai/bitget-agent-mcp 是什么？

统一交易账户的官方Bitget MCP服务器\(UTA / v3\) API——将一个被整理,逐步发现的意图表面\(账号,交易,市场,策略,\.\)暴露给任何MCP相容的AI主机\(Claude Desktop, Cursor, Cursor, Continual,\.

### 如何安装 @bitget-ai/bitget-agent-mcp？

在项目目录运行 npm install @bitget-ai/bitget-agent-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bitget-agent-mcp，可以用 npx bitget-agent-mcp 直接运行。

### @bitget-ai/bitget-agent-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bitget-ai/bitget-agent-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bitget-ai/bitget-agent-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bitget-ai/bitget-agent-mcp 可以商用吗？

@bitget-ai/bitget-agent-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bitget-ai/bitget-agent-mcp 的下载量有多少？

根据 npm 官方下载统计，@bitget-ai/bitget-agent-mcp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,330 次，日均约 78 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bitget-ai/bitget-agent-mcp 还在维护吗？

最新版本 3\.3\.1 发布于 2026/09/20（1 个月前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/06/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。