快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

简化MCP服务器

用于简单智能合约的AI原生开发环境\ 基于模型上下文协议构建，可与AI编码助手无缝集成

![Tests](<>) ![Coverage](<>) ![License](<>)

______________________________________________________________________

🎯 概述

这 简化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接口
自动错误恢复 以及有用的信息
分步指导 用于复杂的操作
详细日志记录 用于调试

______________________________________________________________________

📖 文档

入门指南

快速入门 -2分钟设置指南
安装工具 -工具链安装
马拉松 -竞赛详情

高级

双二进制设置 -二进制选择指南
HAL_隐含_分支 -分支比较
SIMC特性 -编译器功能

例子

示例/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 --version

MCP服务器自动检测并为每个操作使用适当的二进制文件。

看 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.json

MCP配置应如下所示：

{
  "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

______________________________________________________________________

由以下材料制成⚡ 比特币智能合约的未来

目录标签

智能合约区块链开发TypeScriptCursorAI代理本地部署AI辅助开发Simplicity语言Liquid网络

支持客户端

Cursor

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

none

工具数量（toolCount，工具数）

13

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/de4ad4334a55030bb560f6080b34d3fa

Simplicity MCP Server是一个AI原生的开发环境，专为Simplicity智能合约设计，提供编译、部署和交互工具，支持通过自然语言与AI助手进行智能合约开发。

继续浏览同类 MCP

更多运维云端 MCP（13,854）返回 MCP 目录

上一个 MCP

Simple Unity MCP Public

Unity MCP Vision是一款AI辅助的Unity编辑器协同工具，通过FastAPI桥接和Unity编辑器插件，使MCP客户端能够执行可撤销的编辑器工具操作，支持多模态视觉和自然语言指令进行游戏内容原型设计。

下一个 MCP

Simplybook MCP Server

FastMCP SimplyBook Server是一个与SimplyBook.me REST API交互的服务器，提供结构化的方式来管理和集成预约服务。