BSC MCP 服务器

一个用于与币安智能链 (BSC) 网络交互的模型上下文协议 (MCP) 服务器。该服务器使 LLM 能够访问区块链数据并在 BSC 网络上执行查询。

功能

• 获取当前区块号
• 按号码或哈希检索区块详细信息
• 获取交易详情
• 获取交易收据
• 检查钱包 BNB 余额
• 检查 BEP-20 代币余额
• 在 BSC 上创建 Four.meme 代币

前提条件

• Node.js (v16 或更高版本)
• npm 或 yarn

安装

# 克隆存储库
git clone https://github.com/ArcReactor9/BSC_MCP_SERVICES.git
cd BSC_MCP_SERVICES

# 安装依赖
npm install

# 构建项目
npm run build

用法

配置

默认情况下，服务器连接到 BSC 主网。您可以使用环境变量自定义 RPC URL 并设置私钥（创建代币需要）：

# Windows
set BSC_RPC_URL=https://your-custom-bsc-rpc-url
set BSC_PRIVATE_KEY=your-private-key

# Linux/macOS
export BSC_RPC_URL=https://your-custom-bsc-rpc-url
export BSC_PRIVATE_KEY=your-private-key

运行 STDIO 服务器

STDIO 服务器旨在与支持 MCP 协议的 LLM 客户端集成：

npm run start
# 或
node dist/index.js

运行 HTTP/SSE 服务器

HTTP/SSE 服务器允许通过使用服务器发送事件 (Server-Sent Events) 的 HTTP 进行连接：

npm run start:http
# 或
node dist/server-http.js

默认情况下，服务器在端口 3000 上运行。您可以使用 PORT 环境变量自定义端口。

客户端示例

提供了几个客户端实现来演示如何使用 BSC MCP 服务器：

# 标准 MCP 客户端示例
npm run client
# 或
node dist/client-example.js

# HTTP 客户端示例
npm run client:http
# 或
node dist/client-http-example.js

# 简单 HTTP 客户端示例
npm run client:simple
# 或
node dist/simple-http-client.js

API 端点 (HTTP 服务器)

HTTP 服务器公开以下端点：

端点	方法	描述
/	GET	服务器状态检查
/mcp/hello	POST	获取服务器信息和可用工具
/mcp/tools/:toolName	POST	使用参数调用特定工具
/mcp/sse	GET	用于流式连接的服务器发送事件 (SSE) 端点

MCP 工具

此服务器公开以下 MCP 工具：

工具名称	参数	描述
get-block-number	None	返回当前 BSC 区块号
get-block	blockHashOrNumber: string 或 number	返回给定区块哈希或号码的区块详细信息
get-transaction	txHash: string	返回给定交易哈希的交易详细信息
get-transaction-receipt	txHash: string	返回给定交易哈希的交易收据
get-balance	address: string	返回给定钱包地址的 BNB 余额
get-token-balance	tokenAddress: string, walletAddress: string	返回给定代币和钱包地址的 BEP-20 代币余额
create-four-meme-token	name: string, symbol: string, initialSupply: number, decimals: number, ownerAddress: string	使用指定参数创建新的 Four.meme 代币

创建 Four.meme 代币

BSC MCP 服务器包含在币安智能链上创建新的 Four.meme 代币的功能。这允许用户轻松部署具有以下参数的自定义 meme 代币：

• name: 代币的完整名称（例如，“Four Meme Token”）
• symbol: 代币符号（例如，“4MEME”）
• initialSupply: 要铸造的初始代币供应量
• decimals: 代币的小数位数（通常为 18）
• ownerAddress: 将收到初始代币供应量的 BSC 地址

使用 HTTP 客户端的示例

// 使用 HTTP 客户端创建 Four.meme 代币的示例
const client = new SimpleHttpClient('http://localhost:3000');

// 创建一个 Four.meme 代币
const tokenResponse = await client.createFourMemeToken(
  'Four Pepe',   // 代币名称
  '4PEPE',       // 代币符号
  420690000000,  // 初始供应量（小数点前）
  18,            // 小数位数
  '0xYourWalletAddress'  // 所有者地址
);

console.log('代币创建响应：', tokenResponse);

与 MCP.so 集成

为了在 mcp.so 上正确显示此服务，请确保您的存储库包含以下内容：

1. 完善的 README.md（此文件）
2. 演示如何使用这些工具的代码示例
3. 明确定义的工具规范

开发

项目结构

BSC_MCP_SERVICES/
├── dist/               # 编译后的 JavaScript 文件
├── src/                # TypeScript 源代码
│   ├── bsc-service.ts  # BSC 交互服务
│   ├── index.ts        # STDIO 服务器实现
│   ├── server-http.ts  # HTTP/SSE 服务器实现
│   └── ...             # 客户端示例和实用程序
├── package.json        # 项目依赖和脚本
└── README.md           # 项目文档（此文件）

构建项目

npm run build

许可证

ISC

贡献

欢迎贡献！请随时提交 Pull Request。

故障排除

代币创建问题

• 确保 BSC_PRIVATE_KEY 环境变量设置正确
• 验证您是否有足够的 BNB 来支付代币部署的 gas 费用
• 检查所有者地址是否为有效的 BSC 地址

连接问题

• 验证 RPC URL 是否正确且可访问
• 检查网络连接
• 确保服务器在预期的端口上运行

支持

如有任何问题或需要支持，请在 GitHub 存储库上打开一个 issue。