AI导哈

Web3快速开发服务器

SE2-Minikit MCP Server是一个基于Base网络和Farcaster集成的Web3快速开发服务器，提供项目脚手架、配置和部署功能，适用于黑客松参与者和Web3开发者。

  • by troopdegen
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 troopdegen/se2-minikit-mcp-server

使用说明

SE2 Minikit MCP服务器

MCP服务器支持在Base上通过Farcaster集成快速开发Web3

状态: ✅ 基本脚手架功能 版本：0.1.0（阿尔法） 最后更新: 2025-11-07

🚀 快速开始

先决条件

  • 包子 v1.2.16+（用于运行MCP服务器）
  • 克劳德桌面 （用于使用MCP服务器）
  • Git （可选，用于版本控制）

安装

  1. 克隆存储库:

    git clone https://github.com/yourusername/se2-minikit-mcp-server.git
cd se2-minikit-mcp-server

  2. 安装依赖项:

    bun install

  3. 构建服务器:

    bun run build

  4. 配置Claude桌面:

    首先，找到你的Bun路径：

    which bun
# Output example: /Users/yourusername/.bun/bin/bun

    然后添加到您的Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

    {
  "mcpServers": {
    "scaffold-minikit": {
      "command": "/Users/yourusername/.bun/bin/bun",
      "args": ["--silent", "/absolute/path/to/se2-minikit-mcp-server/dist/index.js"],
      "env": {
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}

    重要:

    • 对两者都使用绝对路径 command 以及服务器路径
    • --silent 标志抑制Bun的包管理器输出
    • NODE_ENV=production 禁用漂亮日志记录（防止stdout泄漏）
    • 使用内置 dist/index.js 文件（不是 src/server/index.ts)
    • Claude Desktop不继承shell的PATH

  5. 重新启动克劳德桌面 并验证该服务器是否出现在MCP服务器列表中。

用法

让克劳德为一个项目搭建脚手架：

Create a Scaffold-ETH 2 project called "my-dapp" on Base Sepolia testnet

克劳德将使用 scaffold_project 生成完整项目的工具，包括：

  • 智能合约（Hardhat）
  • Next.js前端
  • 部署脚本
  • 测试基础设施
  • 已安装所有依赖项

生成的项目设置

Claude生成您的项目后：

cd my-dapp

# Start local blockchain
yarn chain

# Deploy contracts (in new terminal)
yarn deploy

# Start frontend (in new terminal)
cd nextjs
yarn install
yarn dev

您的dApp将运行在 http://localhost:3000!

📖 文档

对于用户

面向开发者

项目管理

📚 项目概述

MCP服务器，使开发人员能够使用scaffold ETH 2快速构建、配置和部署去中心化应用程序，并为Farcaster Mini Apps提供可选的Base Minikit集成。

主要特点

  • 🎯 8个MCP工具：脚手架、配置、部署、验证Web3项目
  • ⚡ 6模板：基础、NFT、DeFi、DAO、游戏、社交
  • 🌊 Minikit集成：内置Farcaster Mini应用程序支持
  • 🚀 端网：针对基础主网和测试网进行了优化
  • 💬 自然语言：通过与Claude Code的对话创建dApp

目标用户

  • 需要快速设置dApp的黑客马拉松参与者
  • 基于Base+Farcaster的Web3开发人员
  • 团队原型区块链应用程序

🏗️ 实施状态

进展：35/180故事点（完成19.4%）

✅ 现在什么有效

核心基础设施 （史诗1:完成62.2%）：

  • ✅ 带工具/资源注册表的MCP服务器
  • ✅ 具有变量替换的模板引擎
  • ✅ 具有备份和安全功能的文件管理器
  • ✅ 配置验证（Zod模式）
  • ✅ 结构化日志记录（Pino）
  • ✅ 337项测试通过

项目脚手架:

  • ✅ scaffold_project 工具- 完全可用的
  • ✅ 基本支架ETH 2模板
  • ✅ 网络支持（基础、基础Sepolia、本地主机）
  • ✅ 后一代钩子（yarn install，git init）
  • ✅ 输入验证和错误处理

🚧 进行中/计划中

模板 （剩余5个）：

  • ⏳ NFT模板（ERC-721铸造）
  • ⏳ DeFi模板（令牌交换）
  • ⏳ DAO模板（治理）
  • ⏳ 游戏模板（链上游戏）
  • ⏳ 社交模板（Farcaster集成）

史诗2：脚手架和配置（完成35%）：

  • ✅ 脚手架工程工具
  • ⏳ 配置合同工具
  • ⏳ 合同生效

史诗3：Minikit集成（完成0%）：

  • Farcaster迷你应用支持
  • 基础Minikit组件
  • 帧生成

史诗4：部署管道（已完成0%）：

  • 网络配置
  • 合同部署自动化
  • 验证与确认

看 CURRENT_STATUS.md 详细进展。

🛠️ 可用工具

工具 描述 状态
scaffold_project 初始化脚手架ETH 2项目 ✅ 功能的
add_minikit_support 将Base Minikit添加到现有项目中 ⏳ 计划中
configure_contracts 配置智能合约 ⏳ 计划中
deploy_contracts 部署到基础网络 ⏳ 计划中
setup_farcaster_manifest 生成Farcaster清单 ⏳ 计划中
generate_minikit_components 创建OnchainKit组件 ⏳ 计划中
validate_configuration 部署前验证 ⏳ 计划中
create_frame 生成Farcaster帧 ⏳ 计划中

脚手架_工程工具

状态: ✅ 功能完备的

参数:

  • projectName （必填）：烤肉串案例项目名称（例如“my dapp”）
  • projectPath （可选）：创建项目的位置（默认：当前目录）
  • template （可选）：“基本”|“nft”|“defi”|“dao”|“游戏”|“社交”（默认为“基本”）
  • targetNetwork （可选）：“base”|“baseSepolia”|“localhost”（默认值：“baseSeplia”）
  • contractFramework （可选）：“安全帽”|“代工厂”（默认：“安全帽子”）
  • includesMinikit （可选）：添加Minikit支持（默认值：false）

示例用法:

Ask Claude: "Create a Scaffold-ETH 2 project called 'my-nft-marketplace'"

Claude将使用适当的参数调用该工具并生成一个完整的项目。

📦 项目模板

模板 描述 复杂性 状态
基本的 带钱包连接的简单入门 初学者 ✅ 可用
非同质化代币 ERC-721 NFT铸造平台 中级 ⏳ 计划中
挑战 代币交换和流动性协议 高级 ⏳ 计划中
道 带投票和资金的DAO 高级 ⏳ 计划中
游戏 使用NFT物品进行链上游戏 中级 ⏳ 计划中
社交 Farcaster集成社交应用程序 中级 ⏳ 计划中

基本模板（现在可用）

基本模板包括：

  • 智能合约：简单 YourContract.sol 带安全帽
  • 前端：带有钱包连接的Next.js应用程序（RainbowKit）
  • 部署：已准备好部署脚本
  • 测试：安全帽测试基础设施
  • 配置：环境设置和网络配置

🚀 技术栈

MCP服务器:

  • 包子 v1.2.16+（运行时）
  • TypeScript 5.9.3（严格模式）
  • MCP-SDK v1.21.0
  • 皮诺 （结构化日志）
  • 黄道 （模式验证）

生成的项目:

  • ETH 2支架 （基础框架）
  • 纱线 （包管理器，官方SE2标准）
  • 安全帽 （智能合约）
  • Next.js 14+（前端）
  • 彩虹套件 （钱包连接）
  • 瓦格米 （Web3挂钩）
  • 端网 （主网+Sepolia）

测试:

  • Bun测试 （单元/集成，337次测试）
  • 剧作家 （E2E，计划中）

🤝 贡献

我们欢迎捐款！看 贡献.md 详细指南。

开发环境设置

# Clone and setup
git clone https://github.com/yourusername/se2-minikit-mcp-server.git
cd se2-minikit-mcp-server
bun install

# Run tests
bun test

# Run tests in watch mode
bun test --watch

# Type check
bun run typecheck

# Lint
bun run lint

# Build
bun run build

好的第一个问题

想贡献？查看：

  • 问题#6NFT模板（5分）-创建ERC-721模板
  • 问题#7：DeFi模板（5分）-创建代币交换模板
  • 第8期：高级模板（5分）-DAO/游戏/社交模板

每个模板都遵循与基本模板相同的结构，这使得它们非常适合新的贡献者！

项目结构

se2-minikit-mcp-server/
├── src/
│   ├── server/           # MCP server implementation
│   ├── tools/            # MCP tool handlers
│   ├── resources/        # Resource handlers
│   ├── engines/          # Template/deployment engines
│   ├── config/           # Configuration system
│   ├── types/            # TypeScript types
│   └── utils/            # Utilities
├── templates/            # Project templates
│   └── basic/           # Basic SE2 template
├── tests/
│   ├── unit/            # Unit tests
│   └── integration/     # Integration tests
├── docs/                # Documentation
└── claudedocs/          # Claude-specific docs

📈 开发进度

已完成（35/180分）

✅ 问题1-5、9-11：核心基础设施和基本脚手架

  • 带注册表的MCP服务器骨架
  • 具有变量替换的模板引擎
  • 具有安全功能的文件管理器
  • 配置验证
  • 日志记录基础设施
  • 基本支架ETH 2模板
  • 脚手架工程工具（功能齐全）

后续步骤

短期的 （2-3周）：

  • 问题6-8：其他模板（NFT、DeFi、DAO、游戏、社交）
  • 问题#12:configure_contracts工具
  • 问题13：合同验证

中期 （4-8周）：

  • Epic 3:Minikit集成
  • Epic 4：部署管道

看 工作流.md 完整的路线图。

📊 成功指标

当前表现

  • ✅ 项目脚手架：<10秒
  • ✅ 测试覆盖率：100%（337/337测试通过）
  • ✅ 构建时间：<1秒
  • ✅ TypeScript：严格模式，零错误

目标

  • 创建了1000+个项目（发布后3个月）
  • 任务成功率80%
  • 平均评分>4.5/5

🔗 资源

  • ETH 2支架: https://docs.scaffoldeth.io/llms-full.txt
  • 基础迷你套件: https://docs.base.org/mini-apps/llms-full.txt
  • Farcaster迷你应用程序: https://miniapps.farcaster.xyz/llms-full.txt
  • OnchainKit: https://onchainkit.xyz/
  • MCP协议: https://modelcontextprotocol.io/

🗺️ 路线图

v0.1.0-阿尔法（当前）

  • ✅ 核心MCP服务器基础设施
  • ✅ 具有变量替换的模板引擎
  • ✅ 基本支架ETH 2模板
  • ✅ 脚手架工程工具（功能齐全）
  • ✅ 337项测试通过
  • ✅ TypeScript严格模式

v0.2.0-测试版（2-3周）

  • []NFT模板（ERC-721制造）
  • []DeFi模板（令牌交换）
  • []DAO/游戏/社交模板
  • []配置合同工具
  • []合同生效

v1.0.0-初始版本（8-12周）

  • []已实施所有8个MCP工具
  • []已完成6个项目模板
  • []Minikit集成（Farcaster Mini Apps）
  • []部署管道
  • []安全审计

v1.1.0+-未来

  • 多链支持（乐观主义、仲裁）
  • 高级合同模板
  • 气体优化工具
  • 可视化项目构建器

📄 许可证

[待定]

🙏 致谢

内置：

📞 支持与社区

⚠️ 重要说明

包管理器分离

MCP服务器 用途 包子 用于开发（更快，原生TypeScript）

生成的项目 使用 纱线 （官方脚手架ETH 2标准）

这种分离确保了：

  • ✅ 快速MCP服务器开发
  • ✅ 生成的项目遵循官方的SE2惯例
  • ✅ 用户可以毫无困惑地参考SE2文档

当前限制

  • 只有“基本”模板可用（计划再提供5个模板）
  • 仅支持安全帽（计划铸造）
  • 尚未集成Minikit（计划用于v0.2.0）
  • 还没有自动部署（计划在v1.0.0中）

准备好建造了吗？

  1. 跟随 快速开始 安装MCP服务器
  2. 让克劳德为一个项目搭建脚手架
  3. 开始在Base上构建你的dApp！

有关开发，请参阅 贡献.md 🚀

相关 MCP