🔗 Casper网络MCP服务器v0.1.0
Casper Network区块链的生产就绪模型上下文协议（MCP）服务器
特性 • 快速开始 • 工具 • 提示词 • 安全 • 贡献
______________________________________________________________________
🚀 特性
🏗️ 双服务器架构
- 用于REST API访问的HTTP服务器（Express）
- 用于Claude Desktop集成的MCP stdio服务器
- 两台服务器之间无缝通信
- 具有优雅关机功能的流程管理
- 健康监测端点
🛠️ 专业结构
- 带有独立tools.js的模块化工具系统
- 专用utils.js文件中的实用程序助手
- 清晰地分离关注点
- 易于扩展和维护
- 生产测试组件
🔧 开发者友好
- 简单的JSON-RPC接口
- 全面的错误处理
- 基于环境的配置
- Docker容器化支持
- MCP协议2024-11-05的实施
- 零配置部署，具有合理的默认值
🎯 Casper网络集成
- 钱包创建和管理
- CSPR代币转移
- 质押和委托操作
- 来自主网的实时区块链数据
- 精心策划的验证器数据库（50+顶级验证器）
- 与Casper JavaScript SDK完全集成
______________________________________________________________________
📦 快速开始
✅ 先决条件
# Required
Node.js >= 18.0.0
npm >= 9.0.0
# Casper Network API Key from cspr.cloud
# Get your free API key at: https://cspr.cloud🔑 配置
创建一个 .env 文件中包含您的Casper Network配置：
- CASPER_API_密钥： 来自cspr.cloud的API密钥（必需）
- CASPER_RPC_URL: RPC终结点（默认值：https://node.cspr.cloud/rpc)
- CASPER_NETWORK_NAME： 网络名称（默认：主网为casper）
- 端口： HTTP服务器端口（默认值：8080）
- CASPER_PRIVATE_KEY： 可选默认钱包私钥（PEM格式）
- CASPER_PUBLIC_KEY： 可选默认钱包公钥
📥 安装
# Clone the repository
git clone https://github.com/Tairon-ai/casper-network-mcp.git
cd casper-network-mcp
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env and add your CASPER_API_KEY from cspr.cloud
# Start the HTTP server
npm start
# MCP stdio server for Claude Desktop
npm run mcp🤖 Claude桌面集成
添加到您的Claude Desktop配置中：
{
"mcpServers": {
"casper-network": {
"command": "node",
"args": ["/path/to/casper-network-mcp/mcp/index.js"],
"env": {
"CASPER_API_KEY": "your_api_key_from_cspr_cloud",
"CASPER_RPC_URL": "https://node.cspr.cloud/rpc",
"CASPER_NETWORK_NAME": "casper"
}
}
}
}注： 从获取API密钥https://cspr.cloud用于主网访问
______________________________________________________________________
🛠 可用工具
📋 Casper网络区块链工具
| 工具 | 描述 | 参数 | 返回 |
|---|---|---|---|
create_wallet | 生成新的ED25519钱包 | 无 | 公钥、私钥（PEM）、账户哈希 |
get_balance | 检查CSPR余额 | publicKey （可选） | CSPR和微粒的平衡 |
get_account_info | 获取帐户详细信息 | publicKey （可选） | 帐户哈希、密钥、阈值、钱包 |
transfer_cspr | 发送CSPR代币 | toPublicKey, amount, transferId （可选）， fromPrivateKeyPem （opt） | 部署哈希、交易详细信息 |
delegate_stake | 委派给验证器 | validatorPublicKey, amount, delegatorPrivateKeyPem （opt） | 部署哈希、质押细节 |
undelegate_stake | 从验证器取消授权 | validatorPublicKey, amount, delegatorPrivateKeyPem （opt） | 部署哈希值，取消绑定信息 |
get_staking_rewards | 查看质押信息 | publicKey （可选） | 总赌注、委托、验证器 |
get_validator_info | 获取验证器详细信息 | validatorPublicKey | 姓名、股份、委托人、佣金 |
______________________________________________________________________
🤖 提示词
💬 AI助手提示示例
钱包管理：
"Create a new Casper wallet for me"
"What's my CSPR balance?"
"Check the balance of wallet 01abc123..."
"Show me my Casper account details"转移：
"Send 100 CSPR to wallet 01abc123..."
"Transfer 50 CSPR to 01def456... with transfer ID 12345"质押：
"Delegate 1000 CSPR to validator 012bac..."
"Stake 500 CSPR with Everstake validator"
"Undelegate 500 CSPR from validator 012bac..."
"Show me my staking rewards and delegations"验证程序信息：
"Tell me about Everstake validator 012bac..."
"What's the commission rate and total stake of validator 01c377...?"
"Find validators with 0% commission"🔧 测试工具
# Test wallet creation
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "create_wallet", "arguments": {}}, "id": 1}'
# Test balance check
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "get_balance", "arguments": {"publicKey": "01abc..."}}, "id": 1}'______________________________________________________________________
🔒 安全
🛡️ 安全最佳实践
- 私钥保护 -永不承诺
.env用于版本控制的文件或私钥 - 环境变量 -将敏感数据（API密钥、私钥）存储在环境变量中
- API密钥安全 -保持cspr.cloud API密钥的安全，并且不要共享它
- 输入验证 -所有公钥和金额在处理前都经过验证
- 主网络警告 -此服务器使用真实的CSPR令牌在Casper主网上运行
- 错误处理 -错误不会暴露敏感的钱包信息
- 安全通信 -所有RPC调用都使用HTTPS到cspr.cloud
______________________________________________________________________
🚀 部署
🏭 生产部署
# Start production server
NODE_ENV=production npm start
# With PM2
pm2 start server.js --name casper-mcp
# With Docker
docker build -t casper-mcp .
docker run -d -p 8080:8080 --env-file .env casper-mcp🔑 环境变量
# Casper Network Configuration
CASPER_RPC_URL=https://node.cspr.cloud/rpc
CASPER_API_KEY=your_api_key_from_cspr_cloud
CASPER_NETWORK_NAME=casper
# Optional: Default Wallet
CASPER_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----
CASPER_PUBLIC_KEY=01abc123...
# Server Configuration
PORT=8080
NODE_ENV=production______________________________________________________________________
🤝 贡献
我们欢迎捐款！请阅读 贡献.md 了解我们开发过程的详细信息。
# Fork the repository
git clone https://github.com/Tairon-ai/casper-network-mcp.git
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and commit
git commit -m 'feat: add amazing feature'
git push origin feature/amazing-feature
# Open Pull Request______________________________________________________________________
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
📚 资源
______________________________________________________________________
建造于 Tairon.ai 在克劳德的帮助下