Trading MCP Server

🚀 交易機器人服務器

這是一個基於Bun構建的高性能模型上下文協議（MCP）服務器，用於加密貨幣交易自動化。該項目可實現即時市場數據收集、技術分析以及多加密貨幣資產的自動交易執行。

🚀 快速開始

本項目是一個基於Bun構建的高性能加密貨幣交易自動化服務器。以下是快速開始的步驟：

1. 安裝依賴：確保你已經安裝了Bun v1.3.1或更高版本，然後克隆項目並安裝依賴。
2. 配置環境變量：創建一個.env文件，並設置必要的環境變量，如API密鑰等。
3. 啟動服務器：使用bun run server.ts命令啟動服務器。

# 克隆項目
git clone <your-repo-url>
cd trading-bot-server

# 安裝依賴
bun install

# 配置環境變量
cp .env.example .env
# 編輯.env文件，設置PRIVATE_API_KEY等必要變量

# 啟動服務器
bun run server.ts

✨ 主要特性

• 即時市場數據：獲取加密貨幣資產的即時市場價格和歷史數據。
• 技術分析：在多個時間框架內計算技術指標（如RSI、MACD、布林帶等）。
• 自動交易：以可配置的置信水平執行做多、做空、持有和全部平倉等交易操作。
• 多資產支持：支持比特幣（BTC）、以太坊（ETH）、索拉納（SOL）和HYPE等資產交易（可擴展到其他交易對）。
• 持倉跟蹤：監控和獲取未平倉的交易頭寸。
• 大語言模型集成：利用人工智能模型進行智能交易分析和決策。
• 高性能：基於Bun運行時，性能比Node.js快3倍。

📦 安裝指南

步驟1：克隆或創建項目

# 如果是全新項目
bun init trading-bot-server
cd trading-bot-server

# 或者克隆現有項目
git clone <your-repo-url>
cd trading-bot-server

步驟2：安裝依賴

bun install

這將安裝package.json中定義的所有依賴項，包括：

• MCP協議依賴項
• 市場數據客戶端
• 交易執行庫
• 分析工具

💻 使用示例

基礎用法

示例1：獲取市場數據

// 獲取當前比特幣價格和市場數據
const response = await server.tools.get_market_data({
  symbol: "BTC"
});

console.log(`BTC Price: $${response.price}`);
console.log(`24h Change: ${response.change24h}%`);

示例2：分析技術指標

// 獲取以太坊5分鐘的技術指標
const indicators = await server.tools.get_technical_indicators({
  symbol: "ETH",
  period: "5m"
});

console.log(`RSI: ${indicators.rsi}`);
console.log(`Bollinger Bands Upper: ${indicators.bollingerBands.upper}`);

高級用法

示例3：執行交易

// 在SOL上執行做多交易
const tradeResult = await server.tools.execute_trade({
  symbol: "SOL",
  action: "LONG",
  quantity: 10,
  confidence: 0.75,
  reasoning: "Strong bullish signal from RSI crossover"
});

console.log(`Order ID: ${tradeResult.orderId}`);
console.log(`Status: ${tradeResult.status}`);

示例4：檢查未平倉頭寸

// 獲取所有未平倉頭寸
const positions = await server.tools.get_open_positions();

positions.forEach(position => {
  console.log(`${position.symbol}: ${position.side} ${position.quantity}`);
  console.log(`P&L: $${position.pnl} (${position.pnlPercent}%)`);
});

示例5：使用AI機器人進行自主交易

// 請求AI機器人分析並交易HYPE
const aiTrade = await server.tools.request_ai_trading_bot({
  symbol: "HYPE"
});

console.log(`Analysis: ${aiTrade.analysis.trend}`);
console.log(`Trade Executed: ${aiTrade.tradeExecuted}`);

📚 詳細文檔

配置

設置環境變量

在項目根目錄下創建一個.env文件，並設置以下必需變量：

# 關鍵：所有操作都需要
PRIVATE_API_KEY=your_private_api_key_here
EXCHANGE_API_KEY=your_exchange_api_key
EXCHANGE_SECRET_KEY=your_exchange_secret_key

# 可選：服務器配置
SERVER_PORT=3000
LOG_LEVEL=info
TRADING_MODE=simulation

獲取私有API密鑰

1. 登錄到你的交易平臺賬戶。
2. 導航到設置 → API管理或安全。
3. 創建一個新的API密鑰，並賦予以下權限：
   • 讀取市場數據 ✔
   • 讀取賬戶餘額 ✔
   • 創建訂單 ✔
   • 取消訂單 ✔
4. 複製私鑰並添加到你的.env文件中。
5. 保護好你的密鑰 - 切勿將.env文件提交到版本控制。

環境安全

始終將.env添加到你的.gitignore文件中：

echo ".env" >> .gitignore
echo ".env.local" >> .gitignore
echo "*.key" >> .gitignore

運行服務器

基本執行

bun run server.ts

服務器將在默認端口啟動，並開始監聽MCP協議連接。

使用自定義配置運行

# 使用特定的環境文件運行
export $(cat .env.production | xargs)
bun run server.ts

# 在開發模式下運行，支持熱重載
bun run --watch server.ts

# 增加內存分配運行
bun run --smol server.ts

驗證服務器狀態

啟動後，你應該會看到類似以下的輸出：

✔ Trading Bot Server initialized
✔ Market data provider connected
✔ MCP server listening on port 3000
✔ Ready for connections

調試模式與檢查器

使用MCP檢查器進行調試

MCP檢查器為調試和測試MCP服務器提供了可視化界面，對於以下操作非常有用：

• 測試工具函數調用
• 檢查服務器響應
• 調試交易執行邏輯
• 監控即時數據流

安裝

# 全局安裝MCP檢查器
npm install -g @modelcontextprotocol/inspector
# 或者
bun add -g @modelcontextprotocol/inspector

使用檢查器運行

# 方法1：使用bunx（Bun的包運行器）
bunx @modelcontextprotocol/inspector bun server.ts

# 方法2：使用已安裝的檢查器
mcp-inspector bun server.ts

# 方法3：直接執行並輸出檢查器信息
bun run --inspect server.ts

檢查器界面

運行後，檢查器將提供以下功能：

1. 工具瀏覽器 - 查看所有可用工具及其參數。
2. 請求/響應查看器 - 查看即時API調用和響應。
3. 錯誤跟蹤 - 監控和調試發生的錯誤。
4. 性能指標 - 查看執行時間和資源使用情況。

檢查器工作流程示例

# 1. 啟動檢查器
bunx @modelcontextprotocol/inspector bun server.ts

# 2. 在瀏覽器中打開localhost:3000（檢查器界面）

# 3. 測試市場數據檢索
# - 選擇 "get_market_data" 工具
# - 輸入：{"symbol": "BTC"}
# - 即時查看響應

# 4. 測試交易執行
# - 選擇 "execute_trade" 工具
# - 輸入：{"symbol": "BTC", "action": "LONG", "quantity": 1, "confidence": 0.85}
# - 監控執行和響應

API參考

可用工具

1. get_market_data

獲取指定加密貨幣交易對的當前市場價格和數據。 參數：

• symbol（字符串，必需）：交易對符號 - BTC、ETH、SOL 或 HYPE。 響應：

{
  "symbol": "BTC",
  "price": 45250.50,
  "change24h": 2.35,
  "volume": 28450000000,
  "timestamp": 1698825600000
}

2. get_technical_indicators

計算指定時間框架和交易對的技術分析指標。 參數：

• symbol（字符串，必需）：交易對符號。
• period（字符串，必需）：時間週期 - 5m（5分鐘）或 4h（4小時）。 響應：

{
  "symbol": "BTC",
  "period": "5m",
  "rsi": 65.42,
  "macd": 245.30,
  "bollingerBands": {
    "upper": 46000,
    "middle": 45250,
    "lower": 44500
  }
}

3. get_open_positions

獲取所有當前未平倉的交易頭寸。 響應：

{
  "positions": [
    {
      "symbol": "BTC",
      "side": "LONG",
      "quantity": 0.5,
      "entryPrice": 44000,
      "currentPrice": 45250.50,
      "pnl": 625.25,
      "pnlPercent": 1.42
    }
  ]
}

4. execute_trade

使用指定的參數和置信水平執行交易操作。 參數：

• symbol（字符串，必需）：交易對符號。
• action（字符串，必需）：交易操作 - LONG、SHORT、HOLD 或 CLOSE_ALL。
• quantity（數字，必需）：交易數量（基礎貨幣）。
• confidence（數字，必需）：置信水平（0.0 - 1.0）。
• reasoning（字符串，必需）：交易決策的解釋。 響應：

{
  "status": "executed",
  "orderId": "ORD_1698825650_BTC",
  "symbol": "BTC",
  "action": "LONG",
  "quantity": 0.5,
  "executionPrice": 45250.50,
  "timestamp": 1698825650000
}

5. request_ai_trading_bot

向AI交易機器人MCP服務器發送請求，以收集數據、分析市場並自動執行交易。 參數：

• symbol（字符串，必需）：要分析的交易對符號。 響應：

{
  "status": "processing",
  "analysis": {
    "trend": "bullish",
    "strength": 0.85,
    "recommendation": "LONG"
  },
  "tradeExecuted": true,
  "orderId": "ORD_1698825650_BTC"
}

組件詳情

性能

Bun運行時優勢

Bun相比Node.js提供了顯著的性能提升：

優化提示

1. 使用Bun的內置打包器以實現更快的構建。
2. 啟用緩存以用於市場數據查詢。
3. 批量處理交易操作以減少API調用。
4. 實現速率限制以遵守交易所限制。
5. 監控內存使用，在受限環境中使用bun run --smol。

故障排除

問題：“PRIVATE_API_KEY未找到”

解決方案：

# 驗證項目根目錄中是否存在.env文件
ls -la .env

# 驗證變量是否已設置
grep PRIVATE_API_KEY .env

# 重新加載環境
source .env
bun run server.ts

問題：端口3000連接被拒絕

解決方案：

# 檢查端口是否已被使用
lsof -i :3000

# 殺死現有進程
kill -9 <PID>

# 在不同端口上運行
PORT=3001 bun run server.ts

問題：檢查器未啟動

解決方案：

# 將檢查器更新到最新版本
bun add -g @modelcontextprotocol/inspector@latest

# 嘗試直接使用檢查器命令
mcp-inspector --help

# 替代方案：使用Bun的內置調試器
bun run --inspect-brk server.ts

問題：API密鑰認證失敗

解決方案：

# 驗證API密鑰的格式和編碼
echo $PRIVATE_API_KEY | wc -c

# 使用直接請求測試API密鑰
curl -H "Authorization: Bearer $PRIVATE_API_KEY" \
  https://api.example.com/account

# 檢查是否存在空格問題
PRIVATE_API_KEY=$(echo $PRIVATE_API_KEY | xargs)

問題：內存使用過高

解決方案：

# 在內存受限的情況下運行
bun run --smol server.ts

# 監控內存
ps aux | grep server.ts

# 實現頭寸清理
# 添加定期垃圾回收
setInterval(() => {
  if (global.gc) global.gc();
}, 60000);

問題：市場數據API速率限制

解決方案：

# 實現指數退避
# 添加請求隊列
# 降低輪詢頻率
# 考慮升級API訂閱級別

開發工作流

熱重載開發

bun run --watch server.ts

運行測試

bun test

生產構建

bun build --target bun server.ts --outfile dist/server.js

Docker部署

FROM oven/bun:latest

WORKDIR /app

COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

COPY server.ts .
ENV NODE_ENV=production

EXPOSE 3000

CMD ["bun", "run", "server.ts"]

安全最佳實踐

1. 切勿提交包含API密鑰的.env文件。
2. 使用特定於環境的密鑰用於生產環境。
3. 實現速率限制以防止濫用。
4. 驗證所有外部輸入。
5. 在生產部署中使用HTTPS。
6. 定期輪換API密鑰。
7. 監控交易賬戶的可疑活動。
8. 為交易執行實現請求籤名。

貢獻

要為該項目做出貢獻，請按照以下步驟操作：

1. 創建一個功能分支。
2. 進行更改。
3. 使用檢查器進行徹底測試。
4. 提交拉取請求。

許可證

[在此添加你的許可證]

支持

如有問題、疑問或功能請求，請參考以下途徑：

• GitHub問題：在倉庫中創建一個問題。
• 文檔：查看docs文件夾。
• 調試：使用bunx @modelcontextprotocol/inspector bun server.ts。

額外資源

• Bun文檔
• MCP協議規範
• 交易策略指南
• API集成示例
• 性能調優指南