简化MCP服务器
用于简单智能合约的AI原生开发环境\ 基于模型上下文协议构建，可与AI编码助手无缝集成
______________________________________________________________________
🎯 概述
这 简化MCP服务器 弥合了人工智能驱动的开发工具与Liquid/Elements上的Simplicity智能合约语言之间的差距。它提供了一个完整的工具包，用于直接通过Cursor等对话式AI接口编译、部署和与Simplicity合约交互。
是什么让这个特别
- 零配置 -与Cursor IDE一起开箱即用
- 无需Docker -通过Esplora API直接连接到液体测试网
- 双二进制架构 -编译和签名工具之间的智能选择
- 完成工作流程 -从合同编写到自然语言的区块链部署
- 生产就绪 -综合测试套件，合格率100%
______________________________________________________________________
🚀 快速开始
先决条件
- Node.js 18+
- 游标IDE（或任何兼容MCP的编辑器）
- Rust/Cargo（用于简单工具）
安装
# Clone the repository
git clone https://github.com/your-org/hackathon-satsconf-2025-mcp.git
cd hackathon-satsconf-2025-mcp
# Install dependencies
npm install
# Build and setup
npm run setup
# Restart Cursor就是这样！ MCP服务器现在可以在Cursor中使用。
______________________________________________________________________
💡 用法示例
部署合约
只需在Cursor中提问：
"Deploy the empty contract from examples/ to Liquid Testnet"AI将：
- ✅ 使用编译合同
simc - ✅ 生成合同地址
- ✅ 向testnet水龙头申请资金
- ✅ 验证部署
- ✅ 提供交易详情
检查区块链状态
"What's the current block height on Liquid Testnet?"答复： Block height: 2169092
签署和广播交易
"Create and sign a transaction to spend from this contract"AI将：
- ✅ 创建PSET（部分签名元素事务）
- ✅ 添加UTXO数据
- ✅ 以“简单”计划结束
- ✅ 提取已签名的交易
- ✅ 广播到网络
______________________________________________________________________
🛠️ 核心功能
简单工具集成
| 功能 | 使用的工具 | 说明 |
|---|---|---|
| 编译 | simc | 将.simf文件编译为字节码 |
| 地址生成 | hal-simplicity | 从程序中创建Liquid地址 |
| 交易签名 | hal-simplicity-signer | PSET签名工作流程 |
| 区块链查询 | 探索 API | 实时测试网数据 |
可用MCP工具（共49个）
| 类别 | 计数 | 示例 |
|---|---|---|
| 简洁 | 17 | compile_file, validate, decode |
| 元素 | 16 | get_blockchain_info, get_transaction |
| PSET签名 | 4 | pset_create, pset_finalize, pset_extract |
| 测试网 | 2 | faucet_request_funds, faucet_check_status |
| 助手 | 10 | check_tools, validate_address, list_examples |
______________________________________________________________________
📦 合同示例
存储库包括生产就绪的合同示例：
1.空合同
目的： 尽可能简单的简单程序（始终批准）\ 用例： 测试基础设施，学习基础知识
2.时间锁定合同
目的： 资金锁定至特定区块高度\ 用例： 行权时间表、延期付款
3.哈希时间锁定合约（HTLC）
目的： 带有哈希预映像和超时的有条件支付\ 用例： 原子交换、闪电网络、跨链交易
4.支付给Multisig（P2MS）
目的： 2-of-3多重签名钱包\ 用例： 公司国库、联合账户、DAO
5.保险库合同
目的： 延时退出保护\ 用例： 冷藏、防盗
______________________________________________________________________
🏗️ 建筑
智能二进制选择
服务器会自动为每个操作选择合适的工具：
User Request → MCP Server → Tool Selection
├─ simc (compilation)
├─ hal-simplicity (general ops)
└─ hal-simplicity-signer (signing)示例流程：
- 解析程序 →
hal-simplicity（nums密钥分支） - 创建PSET →
hal-simplicity-signer（pset签名者分支） - 最终确定PSET →
hal-simplicity-signer - 广播 → 探索 API
没有Docker，没问题
与传统设置不同，此服务器直接连接到Blockstream的公共Esplora API：
- ✅ 即时设置 -无需区块链同步
- ✅ 零维护 -没有要管理的本地节点
- ✅ 始终可用 -通过Blockstream实现99.9%的正常运行时间
- ✅ 测试网就绪 -非常适合开发
______________________________________________________________________
📊 技术亮点
代码质量
- 3,500+ TypeScript的行数
- 109 综合测试（100%通过）
- 零 门楣错误
- 类型安全 遍及
- 全面测试覆盖 关键路径
演出
- \<2秒 用于合同编制
- \<1秒 用于区块链查询
- 瞬间 通过MCP进行工具响应
- 高效 缓存和记忆
开发者体验
- 自然语言 通过AI接口
- 自动错误恢复 以及有用的信息
- 分步指导 用于复杂的操作
- 详细日志记录 用于调试
______________________________________________________________________
📖 文档
入门指南
高级
例子
- 示例/README.md -合同示例和教程
______________________________________________________________________
🔧 高级设置
安装简易工具链
# Install simc (Simplicity compiler)
cargo install --git https://github.com/BlockstreamResearch/SimplicityHL.git
# Install hal-simplicity (general operations)
cargo install --git https://github.com/apoelstra/hal-simplicity.git \
--branch 2025-11/nums-key
# Install hal-simplicity-signer (PSET signing)
cargo install --git https://github.com/apoelstra/hal-simplicity.git \
--branch 2025-10/pset-signer \
--bin hal-simplicity
# Rename the signer binary
mv ~/.cargo/bin/hal-simplicity ~/.cargo/bin/hal-simplicity-signer
# Verify installations
simc --version
hal-simplicity --version
hal-simplicity-signer --versionMCP服务器自动检测并为每个操作使用适当的二进制文件。
看 DUAL_BINARY_SETUP.md 了解详细信息。
______________________________________________________________________
🧪 发展
运行测试
npm test # Run all tests
npm run test:watch # Watch mode
npm run test:coverage # Coverage report构建
npm run build # Build TypeScript
npm run lint # Check code quality
npm run format # Format code项目结构
hackathon-satsconf-2025-mcp/
├── src/
│ ├── lib/
│ │ ├── config.ts # Configuration management
│ │ ├── esplora-client.ts # Esplora API client
│ │ ├── simplicity-tools.ts # Simplicity toolchain
│ │ ├── handlers.ts # MCP tool handlers
│ │ └── tools.ts # MCP tool definitions
│ ├── mcp-server.ts # Main server entry point
│ └── types.ts # TypeScript types
├── examples/
│ ├── contracts/ # Example Simplicity contracts
│ └── witnesses/ # Witness templates
├── docs/ # Documentation
└── scripts/ # Setup scripts______________________________________________________________________
🔍 真实世界用例
1.智能合约开发
开发人员可以在不离开IDE的情况下编写、编译和测试Simplicity契约。
2.教育工具
非常适合学习简单性-提出问题并获得即时反馈。
3.快速原型制作
在测试网上快速测试合同创意，无需复杂的设置。
4.集成测试
根据真实的区块链数据验证合同行为。
5.多方工作流程
通过基于PSET的事务签名实现协同开发。
______________________________________________________________________
🐛 故障排除
服务器无法启动或出现“未找到服务器信息”错误
如果在重新启动Cursor后看到“找不到服务器信息”等错误：
# Rebuild the project
cd /path/to/hackathon-satsconf-2025-mcp
npm run build
# Verify the configuration
cat ~/.cursor/mcp.jsonMCP配置应如下所示：
{
"mcpServers": {
"simplicity": {
"command": "node",
"args": [
"/absolute/path/to/hackathon-satsconf-2025-mcp/dist/mcp-server.js"
],
"env": {
"ESPLORA_API_URL": "https://blockstream.info/liquidtestnet/api"
}
}
}
}如果配置不正确，请运行：
npm run setup然后 完全重新启动Cursor （按Cmd+Q或Ctrl+Q，然后重新打开）。
工具未显示在光标中
- 检查
~/.cursor/mcp.json存在并且配置正确 - 验证服务器路径是否正确以及文件是否存在
- 完全重新启动光标（Cmd+Q或Ctrl+Q）
- 检查Cursor的MCP日志是否有错误
API连接问题
服务器使用Blockstream的公共Esplora API。如果您遇到问题：
- 检查您的互联网连接
- 验证API状态：https://blockstream.info/liquidtestnet/api
- 请稍后再试
有关更多帮助，请参阅 QUICKSTART.md.
______________________________________________________________________
🌟 创新亮点
首创
- 首款专为简化而设计的MCP服务器
- 开创人工智能原生智能合约开发
- 区块链工具集成的新方法
技术成就
- 具有智能选择的双二进制架构
- 完成PSET工作流程实施
- 零配置部署管道
开发者影响
- 将合同部署时间从数小时缩短到几分钟
- 无需Docker和本地区块链节点
- 使人工智能辅助开发变得简单
______________________________________________________________________
📄 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
🙏 致谢
为 简单黑客马拉松 在 2025年周六会议.
特别感谢
- 区块流研究 -为了创造简单
- 安德鲁·波尔斯特拉 -为了简化开发和指导
- 模型上下文协议团队 -对于MCP框架
- 元素项目 -对于基础
- 简单社区 -寻求支持和反馈
______________________________________________________________________
🔗 资源
- 简单性： https://github.com/BlockstreamResearch/simplicity
- 简洁HL： https://github.com/BlockstreamResearch/SimplicityHL
- hal简洁性： https://github.com/apoelstra/hal-simplicity
- MCP协议： https://modelcontextprotocol.io
- 液体网络： https://liquid.net
- 探索 API ： https://github.com/Blockstream/esplora
______________________________________________________________________
由以下材料制成⚡ 比特币智能合约的未来