Bsc MCP

🚀 BNBChain MCP

BNBChain MCP是一個全面的模型上下文協議（MCP）服務器，用於與幣安智能鏈（BSC）進行交互，為代幣轉移、去中心化交易所（DEX）操作和智能合約交互提供安全高效的工具。

🚀 快速開始

BNBChain MCP是一個可用於生產環境的MCP服務器，它使AI代理和應用程序能夠與幣安智能鏈生態系統進行交互。以下是快速使用步驟：

1. 初始配置

運行交互式設置嚮導：

bnbchain-mcp --init

嚮導會提示你輸入以下信息：

• BSC錢包私鑰（必填） - 你的錢包私鑰
• 錢包密碼（必填） - 用於加密的密碼，至少6個字符
• 自定義RPC URL（可選） - 默認使用幣安公共RPC

2. 驗證安裝

bnbchain-mcp --version

3. 啟動MCP服務器

npm start
# 或者
node build/index.js

✨ 主要特性

🔐 安全性

• 採用 AES - 256加密 存儲私鑰
• 使用 bcrypt密碼保護 錢包憑證
• 集成 GoPlus安全服務 進行代幣驗證
• 安全的配置管理

💱 去中心化金融（DeFi）操作

• 集成 PancakeSwap V2/V3 進行代幣交換
• 流動性管理（添加/移除頭寸）
• 頭寸跟蹤 和資產組合管理
• 優化燃氣費的交易路由

🪙 代幣管理

• 原生BNB轉移
• 通過符號或地址進行BEP - 20代幣轉移
• 支持模因代幣創建和交易（Four.Meme平臺）
• 代幣安全分析和驗證

🤖 支持AI

• 符合 模型上下文協議（MCP）
• 無縫集成Claude Desktop
• 為AI代理提供結構化工具API
• 採用類型安全的TypeScript實現

📦 安裝指南

前提條件

• Node.js 18+（需要支持ESM）
• npm或yarn包管理器

全局安裝

npm install -g bnbchain-mcp

本地開發

git clone <repository-url>
cd bsc-mcp
npm install
npm run build

💻 使用示例

可用工具

錢包操作

PancakeSwap操作

模因代幣操作

安全與分析

📚 詳細文檔

Claude Desktop集成

初始配置完成後，該工具會自動配置Claude Desktop集成。 配置文件位置：

~/Library/Application Support/Claude/claude_desktop_config.json

MCP服務器將被自動檢測到，並可與Claude Desktop一起使用。

合約地址

開發

構建項目

npm run build

運行測試

# 運行所有測試
npm test

# 運行特定測試套件
npm run test:privateAES

重新配置

若要更新配置：

bnbchain-mcp --init

開發腳本

# 構建並初始化
npm run init:build

# 自動發佈（維護者使用）
npm run publish:auto

架構

項目結構

bsc-mcp/
├── src/
│   ├── cli/              # CLI命令處理程序
│   ├── functions/        # 核心業務邏輯
│   ├── tools/            # MCP工具實現
│   ├── lib/              # 共享庫和ABIs
│   ├── types/            # TypeScript類型定義
│   ├── config.ts         # 配置管理
│   ├── main.ts           # MCP服務器入口點
│   └── index.ts          # CLI入口點
├── build/                # 編譯後的JavaScript輸出
└── scripts/              # 構建和部署腳本

安全架構

• 私鑰加密：使用用戶提供的密碼進行AES - 256加密
• 密碼哈希：使用bcrypt進行安全的密碼存儲
• 配置存儲：加密的本地配置文件
• 代幣驗證：集成GoPlus SDK進行安全檢查

模型上下文協議（MCP）

本項目實現了模型上下文協議，這是一個標準化協議，用於AI代理與外部工具和數據源進行交互。

MCP優勢

• ✅ 結構化通信：類型安全的請求/響應模式
• ✅ AI代理兼容性：可與Claude、OpenAI和其他MCP兼容代理一起使用
• ✅ 安全架構：基於服務器的執行，使用加密憑證
• ✅ 可擴展設計：易於添加新工具和功能

配置

配置以加密格式存儲在以下位置：

• macOS/Linux：~/.bnbchain-mcp/config.json
• Windows：%USERPROFILE%\.bnbchain-mcp\config.json

環境變量

可以設置可選的環境變量：

• BSC_RPC_URL：自定義RPC端點
• MORALIS_API_KEY：Moralis API密鑰，用於增強數據訪問

路線圖

已完成 ✅

• [x] CLI配置嚮導
• [x] Claude Desktop集成
• [x] 代幣部署和轉移
• [x] PancakeSwap V2/V3集成
• [x] 模因代幣交易支持
• [x] 安全分析工具

進行中 🚧

• [ ] 增強錯誤處理和重試邏輯
• [ ] 多錢包支持
• [ ] 交易歷史跟蹤

計劃 📋

• [ ] 代幣圖表集成（DEXTools、CoinGecko）
• [ ] Telegram機器人集成
• [ ] 高級AI交易策略
• [ ] 跨鏈橋支持

貢獻

我們歡迎貢獻！請遵循以下指南：

1. 分叉倉庫 並創建功能分支
2. 遵循TypeScript最佳實踐 並保持類型安全
3. 為新功能添加測試
4. 根據需要更新文檔
5. 提交拉取請求 並提供清晰的描述

開發設置

# 克隆並安裝
git clone <repository-url>
cd bsc-mcp
npm install

# 進行更改並測試
npm run build
npm test

# 提交PR

安全注意事項

⚠️ 重要提示

• 切勿分享你的私鑰 或錢包密碼
• 使用強密碼（至少6個字符，建議更長）
• 確保配置文件安全 且切勿將其提交到版本控制
• 執行交易前驗證代幣地址
• 大額交易前先小額測試
• 交易未知代幣前查看安全檢查結果

故障排除

常見問題

問題：MCP服務器無法連接

• 解決方案：使用 bnbchain-mcp --init 驗證配置

問題：交易失敗

• 解決方案：檢查BNB餘額以支付燃氣費，並驗證RPC端點

問題：Claude Desktop未檢測到服務器

• 解決方案：確保配置文件路徑正確，並重啟Claude Desktop

📄 許可證

本項目採用MIT許可證 - 詳情請參閱LICENSE文件。

支持

如有問題、疑問或想要做出貢獻：

• 在GitHub上創建問題
• 查看現有文檔
• 查看故障排除部分

致謝

• 基於模型上下文協議SDK構建
• 由Viem和PancakeSwap SDK提供支持
• 安全分析由GoPlus提供

為下一代Web3 AI代理而構建 🤖⚡