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

1. 安装依赖项:

   bun install

1. 构建服务器:

   bun run build

1. 配置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

1. 重新启动克劳德桌面 并验证该服务器是否出现在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服务器
• 当前状态 -现在什么有效

面向开发者

• 贡献指南 -如何做出贡献
• 克劳德代码指南 -对于Claude Code实例
• 建筑 -系统设计

项目管理

• 实现工作流 -全部44个问题
• 依赖关系图 -依赖性分析

📚 项目概述

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 详细进展。

🛠️ 可用工具

脚手架_工程工具

状态: ✅ 功能完备的

参数:

• 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将使用适当的参数调用该工具并生成一个完整的项目。

📦 项目模板

基本模板（现在可用）

基本模板包括：

• 智能合约：简单 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 完整的路线图。

📊 成功指标

当前表现

• ✅ 项目脚手架：\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+-未来

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

📄 许可证

\[待定\]

🙏 致谢

内置：

• ETH 2支架
• 基础迷你套件
• OnchainKit
• 远播器
• 模型上下文协议

📞 支持与社区

• 问题:
• 故障排除: 常见问题及解决方案
• 文档: 完成文档
• 状态: 当前实施状态
• 贡献: 贡献指南

⚠️ 重要说明

包管理器分离

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

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

这种分离确保了：

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

当前限制

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

______________________________________________________________________

准备好建造了吗？

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

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