BlockDAG MCP 服务器
一个模型上下文协议(MCP)服务器,将BlockDAG区块链数据带给您的AI助手。您可以直接在Claude桌面版或Cursor中查询余额、交易、代币以及网络统计数据。
为何存在此现象
在人工智能工作流程中处理区块链数据时,不应需要复杂的远程过程调用(RPC)或Web3库。这个MCP服务器填补了这一空白——只需用自然语言询问您的AI助手,即可获取所需数据。
快速入门```bash
git clone https://github.com/daveylupes/blockdag-mcp-server.git
cd blockdag-mcp-server
npm install
cp env.example .env
Edit .env with your BlockDAG RPC details
npm run dev
## 特点/特性
- **10款综合工具** 用于区块链数据访问
- **只读操作** - 默认安全,无需私钥
- **ERC20代币支持** - 查询代币余额和元数据
- **交易分析** - 带分页的历史记录追踪
- **网络监控** - 实时统计的燃气、每秒交易数(TPS)和活动情况
- **类型安全** - 带有严格验证的TypeScript
- **已准备好投入生产** - 全面的错误处理和日志记录
## 工具
| 工具 | 描述 |
|------|-------------|
| `net_info` | 获取链ID和最新区块号 |
| `get_balance` | 获取某个地址的BDAG余额 |
| `tx_receipt` | 通过哈希获取交易收据 |
| `get_block` | 通过标签(最新、十六进制或十进制)获取区块 |
| `get_logs` | 使用过滤器查询事件日志 |
| `read_contract` | 调用只读合约函数 |
| `get_token_balance` 获取ERC20代币余额和元数据
`get_token_info` · 获取代币详情(名称、符号、供应量)
`get_transaction_history` · 获取带分页的交易历史记录
`get_network_stats` · 获取网络统计信息和指标
## 安装
### 先决条件
- Node.js 20 或更高版本
- npm 或 yarn
- BlockDAG RPC端点访问
### 设置
1. **克隆仓库**```bash
git clone https://github.com/daveylupes/blockdag-mcp-server.git
cd blockdag-mcp-server
- 安装依赖项```bash
npm install
1. **配置环境**```bash
cp env.example .env
编辑 .env:```bash
BLOCKDAG_RPC_URL=https://your-blockdag-rpc
BLOCKDAG_CHAIN_ID=12345
1. **构建项目**```bash
npm run build
使用
使用Cursor
创建或编辑 ~/.cursor/mcp.json:```json
{
"mcpServers": {
"blockdag": {
"command": "node",
"args": ["/absolute/path/to/blockdag-mcp-server/dist/index.js"],
"env": {
"BLOCKDAG_RPC_URL": "https://your-blockdag-rpc",
"BLOCKDAG_CHAIN_ID": "12345"
}
}
}
}
重启光标,然后提出诸如以下问题:
- “地址0x...的余额是多少?”
- “显示网络统计信息”
- “获取合约0x...的代币信息”
### 使用Claude Desktop
编辑您的Claude桌面配置:```json
{
"mcpServers": {
"blockdag": {
"command": "node",
"args": ["/absolute/path/to/blockdag-mcp-server/dist/index.js"],
"env": {
"BLOCKDAG_RPC_URL": "https://your-blockdag-rpc",
"BLOCKDAG_CHAIN_ID": "12345"
}
}
}
}
使用MCP Inspector进行测试```bash
npm install -g @modelcontextprotocol/inspector
mcp-inspector
选择“本地标准I/O进程”并指向 `node dist/index.js`
## 发展```bash
# Run in development mode
npm run dev
# Build for production
npm run build
# Type checking
npm run type-check
# Run tests
npm test
项目结构```
blockdag-mcp-server/
├── src/
│ ├── index.ts # Main server and tool implementations
│ ├── chain.ts # BlockDAG chain configuration
│ └── types.ts # Shared types and utilities
├── docs/
│ ├── features/ # Feature documentation
│ └── guides/ # User guides
├── tests/ # Test files
├── dist/ # Compiled output
└── README.md
## 文档
- **测试指南** - 如何测试服务器
- **故障排除** - 常见问题及解决方案
- **做出贡献** - 如何做出贡献
- **更新日志** - 版本历史
### 特色文档
- **ERC20代币支持**
- **交易历史**
- **网络统计**
## 示例
### 获取网络信息```
"What's the current BlockDAG network status?"
检查余额```
"What's the BDAG balance of 0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6?"
### 代币余额```
"Check token balance for wallet 0x... and token contract 0x..."
网络统计```
"Show me current gas prices and network performance"
### 交易历史```
"Get the last 10 transactions for address 0x..."
安全
- 默认为只读 - 无私钥或签名操作
- 输入验证 - 所有输入均通过Zod模式进行验证
- 错误净化(或错误处理/错误清理) - 错误信息不泄露敏感内容
- 类型安全 - TypeScript 严格模式防止常见错误
贡献;做出贡献
我们欢迎所有贡献!无论是修复漏洞、添加功能,还是改进文档——所有贡献都备受重视。
贡献方式
- 🐛 报告错误或问题
- 💡 建议新功能
- 📝 完善文档
- 🔧 提交拉取请求
- ⭐ 如果你觉得这个仓库有用,就给它点个星吧
社区
- GitHub Issues(在GitHub上的问题/议题) - 报告错误或请求功能
- 拉取请求(或称为合并请求) - 贡献代码改进
- 讨论 - 分享想法并寻求帮助
路线图
- [ ] 支持实时更新的WebSocket
- [ ] 缓存层以提高性能
- [ ] 支持多网络配置
- [ ] 高级过滤和聚合
- [ ] 支持批量查询
- [ ] 支持NFT(ERC721/ERC1155)
性能注意事项
用于高产量生产:
- 考虑使用区块浏览器API来查看交易历史
- 为频繁查询的数据实现缓存
- 为网络统计使用更小的区块范围
- 见 性能指南
许可证
MIT 许可证 - 详见 许可证 详情如下。
致谢
为BlockDAG社区而建。感谢所有贡献者、测试者和提供反馈的人。
为区块链开发者倾心打造
