一个基于 Model Context Protocol (MCP) 的微信小程序开发者工具服务器，为 AI 助手提供小程序开发能力。

npm install -g weapp-devtools-mcp

在您的 MCP 客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "weapp-devtools": {
      "command": "weapp-devtools-mcp"
    }
  }
}

1. 安装微信开发者工具: 从官方网站下载并安装
2. 开启服务端口: 在开发者工具的 设置 -> 安全设置 中开启服务端口
3. Node.js 环境: 需要 Node.js 16+ 版本

• 登录管理: 微信开发者工具登录状态管理
• 代码预览: 生成小程序预览二维码
• 代码上传: 上传小程序代码到微信平台
• 自动预览: 自动生成预览二维码
• npm 构建: 构建小程序 npm 依赖
• 缓存管理: 清除开发者工具缓存
• 工具管理: 启动、关闭开发者工具
• 云开发: 云函数和云环境管理

工具名称	描述	主要参数
weapp_login	登录开发者工具	qrFormat, qrSize, qrOutput
weapp_check_login	检查登录状态	无
weapp_preview	生成预览二维码	project, qrFormat, qrOutput
weapp_auto_preview	自动预览	project, infoOutput
weapp_upload	上传代码	project, version, desc
weapp_build_npm	构建 npm	project, compileType
weapp_cache_clear	清除缓存	project
weapp_open_tool	启动工具	project
weapp_close_project	关闭项目	project
weapp_quit_tool	退出工具	无
weapp_cloud_functions_list	云函数列表	project
weapp_cloud_functions_deploy	部署云函数	project, functionName, functionPath

配置完成后，您可以在支持 MCP 的 AI 客户端中通过自然语言调用微信小程序开发功能：

请帮我预览微信小程序项目
路径：/path/to/miniprogram

AI 助手将自动调用相应的工具，生成预览二维码。

请登录微信开发者工具

请预览小程序项目 /path/to/my-miniprogram

请上传小程序代码，版本号 1.0.1，描述：修复登录问题
项目路径：/path/to/my-miniprogram

请为小程序项目构建 npm 依赖
项目路径：/path/to/my-miniprogram

1. 连接失败

   • 检查微信开发者工具是否已启动
   • 确认在 设置 -> 安全设置 中已开启服务端口

2. CLI 工具未找到

   • 确保已正确安装微信开发者工具
   • 重启终端或 AI 客户端

3. 项目路径错误

   • 确保项目路径存在且包含有效的 project.config.json 文件
   • 使用绝对路径而非相对路径

4. 登录状态失效

   • 重新执行登录命令
   • 检查网络连接

如需启用调试模式，可在配置中添加环境变量：

{
  "mcpServers": {
    "weapp-devtools": {
      "command": "weapp-devtools-mcp",
      "env": {
        "DEBUG": "mcp:*"
      }
    }
  }
}

• 微信小程序官方文档
• 微信开发者工具 CLI 文档
• 微信开发者工具下载
• Model Context Protocol

如果您遇到问题或有建议，请：

1. 查看 GitHub Issues
2. 创建新的 Issue
3. 联系维护者

MIT License - 查看 LICENSE 文件了解详情。

---

注意: 使用前请确保已正确安装微信开发者工具，并在安全设置中开启服务端口。