Farcaster Dev MCP Server

Farcaster开发MCP服务器

一个全面的模型上下文协议（MCP）服务器，旨在加速Farcaster Mini App的开发。该服务器为开发人员提供了在Farcaster协议上构建成功的迷你应用程序所需的基本工具、代码生成功能和广泛的知识库。

🚀 特性

🛠️ 开发工具（30+工具）

• 项目设置：创建新的迷你应用程序，生成清单，设置开发环境
• 认证：实现Farcaster登录（SIWF），管理用户会话
• 钱包集成：配置Wagmi、处理交易、管理钱包事件
• SDK集成：初始化Farcaster SDK，处理事件，实现通知
• 发展：启动开发服务器、生成测试、调试应用程序
• 出版：部署应用程序、设置分析、创建共享链接

📚 知识库

• 核心概念：迷你应用架构、清单规范、SDK概述
• 认证：SIWF实施模式、会话管理策略
• 钱包集成：事务处理、链配置、错误管理
• 最佳实践：移动优化、安全指南、性能提示

📦 安装

# Clone or create the project
git clone 
cd farcaster-dev-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

# Start development mode
npm run dev

🔧 配置

MCP客户端设置

使用Claude MCP CLI（推荐）

在本地添加服务器：

claude mcp add farcaster-dev-mcp-server node /Users/osx/Projects/MCP-SERVERS/farcaster-dev-mcp-server/dist/index.js

或者为所有用户全局添加：

claude mcp add farcaster-dev-mcp-server -s user node /Users/osx/Projects/MCP-SERVERS/farcaster-dev-mcp-server/dist/index.js

手动配置

将服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "farcaster-dev-mcp-server": {
      "command": "node",
      "args": ["./dist/index.js"],
      "cwd": "./farcaster-dev-mcp-server"
    }
  }
}

环境变量

创建一个 .env 项目根目录中的文件：

NODE_ENV=development
LOG_LEVEL=info

🛠️ 可用工具

项目设置工具

• farcaster_create_mini_app -创建一个新的Farcaster Mini应用程序项目
• farcaster_generate_manifest -为迷你应用程序生成清单文件
• farcaster_validate_manifest -验证清单文件合规性
• farcaster_setup_dev_environment -设置开发环境

身份验证工具

• farcaster_implement_siwf -生成SIWF实现代码
• farcaster_generate_auth_flow -创建完整的身份验证流程
• farcaster_validate_user -验证用户身份验证
• farcaster_get_user_profile -获取用户配置文件信息

钱包集成工具

• farcaster_setup_wallet_integration -设置Wagmi钱包集成
• farcaster_generate_transaction -生成交易处理代码
• farcaster_configure_chains -配置区块链网络
• farcaster_handle_wallet_events -处理钱包连接事件

SDK集成工具

• farcaster_initialize_sdk -初始化Farcaster迷你应用SDK
• farcaster_handle_sdk_events -处理SDK生命周期事件
• farcaster_implement_notifications -设置通知系统
• farcaster_generate_navigation -创建导航模式
• farcaster_implement_sharing -实施社交分享

开发工具

• farcaster_start_dev_server -启动本地开发服务器
• farcaster_generate_test_suite -生成全面的测试
• farcaster_debug_mini_app -生成调试实用程序
• farcaster_optimize_performance -性能优化工具
• farcaster_generate_error_boundary -创建错误边界

发布工具

• farcaster_publish_mini_app -使用清单托管发布迷你应用程序
• farcaster_generate_share_link -生成可共享链接
• farcaster_setup_analytics -设置分析和监控
• farcaster_generate_deployment_script -生成部署脚本
• farcaster_validate_deployment -验证部署设置

知识库工具

• farcaster_get_knowledge -访问分类知识主题
• farcaster_search_knowledge -在知识库中搜索
• farcaster_list_topics -列出所有可用主题

📚 知识类别

核心概念

• 迷你应用程序概述和架构
• 清单文件规范
• SDK概述和功能

认证

• 使用Farcaster登录（SIWF）实施
• 用户会话管理
• 配置文件集成模式

钱包集成

• Wagmi设置和配置
• 交易处理（单笔和批量）
• 钱包事件管理

最佳实践

• 移动优先设计原则
• 全面的错误处理
• 安全指南和验证

🎯 快速入门示例

// Create a new Mini App
{
  "tool": "farcaster_create_mini_app",
  "arguments": {
    "name": "My Awesome Mini App",
    "homeUrl": "https://myapp.com",
    "framework": "react",
    "includeWallet": true,
    "includeAuth": true
  }
}

// Get knowledge about authentication
{
  "tool": "farcaster_get_knowledge",
  "arguments": {
    "category": "authentication",
    "topic": "siwf-implementation"
  }
}

// Setup wallet integration
{
  "tool": "farcaster_setup_wallet_integration",
  "arguments": {
    "framework": "react",
    "chains": ["ethereum", "base", "optimism"],
    "includeConnectors": ["miniapp", "injected"]
  }
}

🏗️ 项目结构

src/
├── tools/              # MCP tools organized by category
│   ├── project-setup.ts
│   ├── auth.ts
│   ├── wallet.ts
│   ├── sdk-integration.ts
│   ├── development.ts
│   └── publishing.ts
├── knowledge/          # Knowledge base with categorized topics
│   ├── core-concepts.ts
│   ├── authentication.ts
│   ├── wallet-integration.ts
│   ├── best-practices.ts
│   └── index.ts
├── handlers/           # Tool implementation handlers
├── types/             # TypeScript type definitions
└── index.ts           # Main MCP server

🔍 使用示例

创建新的迷你应用程序

# Use the MCP client to call:
farcaster_create_mini_app {
  "name": "Weather Mini App",
  "homeUrl": "https://weather.myapp.com",
  "framework": "react",
  "includeWallet": true,
  "includeAuth": true
}

这将生成一个完整的React项目：

• Farcaster SDK集成
• 与Wagmi的钱包连接
• 身份验证流程
• 移动优化布局
• TypeScript配置
• 开发工具

获取身份验证帮助

# Search for authentication knowledge
farcaster_search_knowledge {
  "query": "sign in with farcaster",
  "categories": ["authentication"]
}

# Get specific implementation guidance
farcaster_get_knowledge {
  "category": "authentication",
  "topic": "siwf-implementation"
}

设置钱包集成

# Generate Wagmi configuration
farcaster_setup_wallet_integration {
  "framework": "react",
  "chains": ["ethereum", "base"],
  "includeConnectors": ["miniapp", "injected"]
}

# Generate transaction handling code
farcaster_generate_transaction {
  "transactionType": "erc20-transfer",
  "includeGasEstimation": true,
  "includeTxPreview": true
}

🛡️ 安全最佳实践

服务器包括全面的安全指南：

• 输入验证模式
• 安全会话管理
• 交易安全措施
• 内容安全策略设置
• 环境变量处理

🤝 贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📋 发展路线图

• \[\]增强的测试工具和模式
• \[\]高级调试实用程序
• \[\]性能监控集成
• \[\]额外的框架支持（Vue、Svelte）
• \[\]扩展发布平台集成
• \[\]高级分析实施

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 法尔卡斯特 因为令人惊叹的协议
• 模型上下文协议 对于框架
• Farcaster开发者社区提供灵感和反馈

📞 支持

• 文档: Farcaster迷你应用文档
• 社区: Farcaster Discord
• 问题:

______________________________________________________________________

内置于❤️ Farcaster开发者社区