星战科技xingzhan.cloud
返回市场
基础服务-mcp

基础服务-mcp

作者：Delyar24 星标更新：2025-11-13
安装使用来源：spider==github.com

项目介绍

BNBChain MCP

一个全面的模型上下文协议（MCP）服务器，用于与币安智能链（BSC）交互，提供安全高效的工具，用于代币转移、去中心化交易所操作以及智能合约交互。

License: MIT TypeScript Node.js

概述

BNBChain MCP 是一个生产就绪的 MCP 服务器，使 AI 代理和应用程序能够与币安智能链生态系统进行交互。它提供了安全且类型安全的区块链操作接口，包括代币转移、PancakeSwap 集成、梗代币交易以及全面的钱包管理。

主要功能

🔐 安全性

  • 使用 AES-256 加密 存储私钥
  • 使用 bcrypt 密码保护 钱包凭证
  • 集成 GoPlus 安全 进行代币验证
  • 安全配置管理

💱 去中心化金融操作

  • PancakeSwap V2/V3 集成 用于代币交换
  • 流动性管理（添加/移除仓位）
  • 仓位跟踪及投资组合管理
  • 优化气体费用的交易路由

🪙 代币管理

  • 本机 BNB 转移
  • 通过符号或地址转移 BEP-20 代币
  • 梗代币创建和交易（Four.Meme 平台）
  • 代币安全性分析和验证

🤖 AI 就绪

  • 符合 模型上下文协议（MCP）
  • 无缝集成 Claude Desktop
  • 适用于 AI 代理的结构化工具 API
  • 类型安全的 TypeScript 实现

技术栈

组件技术
区块链币安智能链（BSC）
Web3 库Viem 2.23.11
DEX SDKPancakeSwap SDK 5.8.8
协议模型上下文协议 SDK 1.4.0
语言TypeScript (ESM)
安全AES-256, bcrypt
数据提供商Moralis SDK 2.27.2
代币安全GoPlus SDK 1.0.12

支持的网络

BNB 智能链主网

  • 链 ID: 56
  • 默认 RPC: https://bsc-dataseed.binance.org
  • 自定义 RPC: 可通过环境设置配置

安装

先决条件

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

全局安装

npm install -g bnbchain-mcp

本地开发

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

快速开始

1. 初始配置

运行交互式设置向导：

bnbchain-mcp --init

向导会提示您输入：

  • BSC 钱包私钥（必需）- 您钱包的私钥
  • 钱包密码（必需）- 至少 6 个字符用于加密
  • 自定义 RPC URL（可选）- 默认为币安公共 RPC

2. 验证安装

bnbchain-mcp --version

3. 启动 MCP 服务器

npm start
# 或
node build/index.js

Claude Desktop 集成

初始配置后，工具会自动配置 Claude Desktop 集成。

配置文件位置：

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

MCP 服务器将被自动检测并可用于 Claude Desktop。

可用工具

钱包操作

工具描述参数
transferNativeToken将 BNB 转移到钱包地址to, amount
transferBEP20Token通过符号或地址转移 BEP-20 代币token, to, amount
getWalletInfo获取综合钱包信息address
getBalance获取地址的代币和原生余额address, token（可选）

PancakeSwap 操作

工具描述参数
pancakeSwap通过 PancakeSwap 执行代币交换tokenIn, tokenOut, amount, slippage
pancakeAddLiquidity向 PancakeSwap 池添加流动性tokenA, tokenB, amountA, amountB
pancakeMyPosition查看您的 PancakeSwap 流动性仓位poolAddress（可选）
pancakeRemovePosition从 PancakeSwap 移除流动性poolAddress, liquidity

梗代币操作

工具描述参数
buyMemeToken在 Four.Meme 上购买梗代币tokenAddress, amount
sellMemeToken在 Four.Meme 上出售梗代币tokenAddress, amount
queryMemeTokenDetails获取关于梗代币的详细信息tokenAddress

安全与分析

工具描述参数
securityCheck对代币执行 GoPlus 安全分析tokenAddress

合约地址

合约类型地址描述
Four.Meme 尝试购买0xF251F83e40a78868FcfA3FA4599Dad6494E46034代币购买合约
Four.Meme 购买/出售 AMAP0x5c952063c7fc8610FFDB798152D69F0B9550762b自动市场调整定价
Four.Meme 创建代币0x5c952063c7fc8610FFDB798152D69F0B9550762b代币工厂合约
PancakeSwap 路由器 V2通过 SDK 集成DEX 路由和交换
PancakeSwap V3 池通过 SDK 访问流动性池管理

开发

构建项目

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 密钥，用于增强的数据访问

发展路线图

已完成 ✅

  • CLI 配置向导
  • Claude Desktop 集成
  • 代币部署和转移
  • PancakeSwap V2/V3 集成
  • 梗代币交易支持
  • 安全分析工具

正在进行中 🚧

  • 增强错误处理和重试逻辑
  • 多钱包支持
  • 交易历史追踪

计划中 📋

  • 代币图表集成（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 上打开一个问题
  • 查阅现有文档
  • 查看故障排除部分

致谢

为下一代 Web3 AI 代理构建 🤖⚡