Bybit MCP 服务器

模型上下文协议 (MCP)服务器提供对 Bybit 加密货币交换 API 的只读访问。

这是 Alpha 质量软件 - 使用风险自负！

请务必在此服务器上使用只读 API 密钥。我不会将您的“钱”托付给我的代码，您也一样！

Started integrated server
Chatting with llama-3.2-11b-instruct:Q8_0 (Ctrl+C to exit)
Tools are available - ask about cryptocurrency data!

You: Whats the current spot price for USDT/BTC?

Assistant: <tool>get_ticker</tool>
<arguments>
{
  "category": "spot",
  "symbol": "BTCUSDT"
}
</arguments>

Tool result: {
  "timestamp": "2024-12-14T12:32:30.628Z",
  "meta": {
    "requestId": "ad5177bc-93d1-49ed-80a1-dd95b3ec970b"
  },
  "symbol": "BTCUSDT",
  "category": "spot",
  "lastPrice": "101368.71",
  "price24hPcnt": "0.0107",
  "highPrice24h": "102661.3",
  "lowPrice24h": "99683.96",
  "prevPrice24h": "100292.67",
  "volume24h": "22543.911683",
  "turnover24h": "2285318788.68303381",
  "bid1Price": "101366.07",
  "bid1Size": "0.136049",
  "ask1Price": "101366.08",
  "ask1Size": "0.648039",
  "usdIndexPrice": "101365.707576"
}

Processing result...

The current spot price for USDT/BTC is $101,368.71.

特征

该 MCP 服务器提供以下工具用于与 Bybit 的 API 交互：

get_ticker ：获取交易对的实时股票行情信息
get_orderbook ：获取交易对的订单簿（市场深度）数据
get_kline ：获取交易对的 K 线/K 线数据
get_market_info ：获取交易对的详细市场信息
get_trades ：获取交易对的近期交易
get_instrument_info ：获取特定交易对的详细工具信息
get_wallet_balance ：获取已验证用户的钱包余额信息
get_positions ：获取已验证用户的当前位置信息
get_order_history ：获取经过身份验证的用户的订单历史记录

要求和安装

Node.js（v20+）
pnpm（ npm i -g pnpm ）
如果您想运行 Ollama 客户端（如下面的快速入门所示），您需要安装并运行 Ollama，以及您选择的模型。

pnpm i

快速入门

要安装软件包，请构建所有内容并启动交互式客户端：

pnpm i

将 .env.example 文件复制到 .env 并填写您的详细信息。

cp .env.example .env
code .env

MCP 服务器（仅限）

pnpm serve

MCP-Server 和 Ollama 客户端

安装所需的客户端包：

(cd client && pnpm i)

将客户端 .env.example 文件复制到 .env 并填写您的详细信息。

cp client/.env.example client/.env
code client/.env

然后通过一个命令启动客户端和服务器：

pnpm start

配置

环境变量

服务器需要将 Bybit API 凭证设置为环境变量：

BYBIT_API_KEY ：您的 Bybit API 密钥（必需）
BYBIT_API_SECRET ：您的 Bybit API 密钥（必需） -重要 - 仅创建只读 API 密钥！
BYBIT_USE_TESTNET ：设置为“true”以使用测试网而不是主网（可选，默认为 false）
DEBUG ：设置为“true”以启用调试日志记录（可选，默认为 false）

客户端环境变量（./client/.env）：

OLLAMA_HOST ：Ollama 服务器的主机（默认为http://localhost:11434 ）
DEFAULT_MODEL ：用于聊天的默认模型（默认为 llama-3.2-11b-instruct:Q8_0）

MCP 设置配置

要将此服务器与 MCP 客户端一起使用，您需要将其添加到 MCP 设置配置文件中。文件位置取决于您的客户端：

MCP 示例 - Claude 桌面

位置： ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bybit": {
      "command": "node",
      "args": ["/path/to/bybit-mcp/build/index.js"],
      "env": {
        "BYBIT_API_KEY": "your-api-key",
        "BYBIT_API_SECRET": "your-api-secret",
        "BYBIT_USE_TESTNET": "false"
      }
    }
  }
}

MCP 示例 - gomcp

位置： ~/.config/gomcp/config.yaml

mcp_servers:
  - name: "bybit"
    command: "cd /path/to/bybit-mcp && pnpm run serve"
    arguments: []
    env:
      BYBIT_API_KEY: ""      # Add your Bybit API **READ ONLY** key here
      BYBIT_API_SECRET: ""   # Add your Bybit API **READ ONLY** secret here
      BYBIT_USE_TESTNET: "true"  # Set to false for production
      DEBUG: "false"         # Optional: Set to true for debug logging

客户端集成

此软件包包含一个 TypeScript 客户端，该客户端提供命令行界面，用于与 Ollama LLM 和 bybit-mcp 服务器交互。该客户端支持：

与 Ollama 模特互动聊天
直接访问所有 bybit-mcp 交易工具
自动服务器管理
基于环境的配置
调试日志记录

有关详细的客户端文档，请参阅客户端 README 。

运行服务器

生产

构建服务器：

pnpm build

运行服务器：

node build/index.js

发展

对于使用自动 TypeScript 重新编译进行开发：

pnpm watch

在开发过程中检查 MCP 服务器：

pnpm inspector

工具文档

获取股票信息

{
  "name": "get_ticker",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot" // optional, defaults to "spot"
  }
}

获取订单簿数据

{
  "name": "get_orderbook",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "limit": 25 // optional, defaults to 25 (available: 1, 25, 50, 100, 200)
  }
}

获取K线/K线数据

{
  "name": "get_kline",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "interval": "1", // optional, defaults to "1" (available: "1", "3", "5", "15", "30", "60", "120", "240", "360", "720", "D", "M", "W")
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

获取市场信息

{
  "name": "get_market_info",
  "arguments": {
    "category": "spot", // optional, defaults to "spot"
    "symbol": "BTCUSDT", // optional, if not provided returns info for all symbols in the category
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

获取最近交易

{
  "name": "get_trades",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

获取仪器信息

{
  "name": "get_instrument_info",
  "arguments": {
    "symbol": "BTCUSDT", // required
    "category": "spot" // optional, defaults to "spot"
  }
}

返回有关交易工具的详细信息，包括：

基础货币和报价货币
交易状态
批量过滤器（最小/最大订单数量）
价格过滤器（刻度大小）
杠杆设置（针对期货）
合约详情（针对期货）

获取钱包余额

{
  "name": "get_wallet_balance",
  "arguments": {
    "accountType": "UNIFIED", // required (available: "UNIFIED", "CONTRACT", "SPOT")
    "coin": "BTC" // optional, if not provided returns all coins
  }
}

获取职位

{
  "name": "get_positions",
  "arguments": {
    "category": "linear", // required (available: "linear", "inverse")
    "symbol": "BTCUSDT", // optional
    "baseCoin": "BTC", // optional
    "settleCoin": "USDT", // optional
    "limit": 200 // optional, defaults to 200
  }
}

获取订单历史记录

{
  "name": "get_order_history",
  "arguments": {
    "category": "spot", // required (available: "spot", "linear", "inverse")
    "symbol": "BTCUSDT", // optional
    "baseCoin": "BTC", // optional
    "orderId": "1234567890", // optional
    "orderLinkId": "myCustomId", // optional
    "orderStatus": "Filled", // optional (available: "Created", "New", "Rejected", "PartiallyFilled", "PartiallyFilledCanceled", "Filled", "Cancelled", "Untriggered", "Triggered", "Deactivated")
    "orderFilter": "Order", // optional (available: "Order", "StopOrder")
    "limit": 200 // optional, defaults to 200
  }
}

支持的类别

spot ：现货交易
linear ：线性永续合约
inverse ：逆向永续合约

执照

麻省理工学院

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

模型上下文协议服务器提供对 Bybit 加密货币交换 API 的只读访问，允许用户使用自然语言查询实时加密货币数据。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Coin MCP Server
longmans
A
security
F
license
A
quality
A Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data, enabling AI applications to retrieve cryptocurrency listings, quotes, and detailed information.
Last updated -
3
10
Python
Binance MCP Server
tienan92it
-
security
A
license
-
quality
A Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.
Last updated -
4
Python
MIT License
Realtime Crypto MCP Server
smhnkmr
-
security
-
license
-
quality
A server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.
Last updated -
1
TypeScript
MIT License
Satstream MCP Serverofficial
satstream
A
security
A
license
A
quality
A Model Context Protocol server that enables querying Bitcoin blockchain data, including address information, transaction details, mempool statistics, and ordinals/runes data through the Satstream API.
Last updated -
37
TypeScript
MIT License

View all related MCP servers

Bybit MCP Server