# mcp-wechat-devtools

**Repository Path**: pauljoihn21/mcp-wechat-devtools

## Basic Information

- **Project Name**: mcp-wechat-devtools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP WeChat DevTools

微信小程序开发者工具的 MCP (Model Context Protocol) Server。

让 AI 助手直接控制微信开发者工具——打开项目、预览、上传、构建 NPM、自动化测试。

## 功能

| Tool | 说明 |
|------|------|
| `open_project` | 在微信开发者工具中打开小程序项目 |
| `preview_project` | 预览小程序，生成二维码（terminal/image/base64） |
| `upload_code` | 上传小程序代码到微信平台 |
| `build_npm` | 构建小程序 NPM 依赖 |
| `close_project` | 关闭指定项目 |
| `quit_devtools` | 退出微信开发者工具 IDE |
| `check_login` | 检查登录状态 |
| `login_devtools` | 重新登录 |
| `clean_cache` | 清理缓存 |
| `enable_automation` | 启用自动化模式 |

## 安装

```bash
# 从源码构建
git clone https://gitee.com/pauljoihn21/mcp-wechat-devtools.git
cd mcp-wechat-devtools
cargo build --release

# 二进制位置: target/release/mcp-wechat-devtools
```

## IDE 配置

### CatPaw / Cursor

在 MCP 配置文件中添加：

```json
{
  "mcpServers": {
    "wechat-devtools": {
      "command": "/path/to/mcp-wechat-devtools",
      "args": []
    }
  }
}
```

### 使用示例

配置完成后，AI 助手可以：

- "打开 /Users/me/project/dist/mp 在微信开发者工具中"
- "预览这个小程序项目"
- "上传代码，版本 1.0.0，备注 'first release'"
- "构建 npm 依赖"
- "检查微信开发者工具是否已登录"

## 前置条件

1. **微信开发者工具** 已安装（macOS 默认路径：`/Applications/wechatwebdevtools.app`）
2. 下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
3. 已登录微信开发者工具（`check_login` 或 `login_devtools`）

## 技术架构

```
AI 助手 ←(JSON-RPC 2.0 over stdio)→ MCP Server ←(CLI)→ 微信开发者工具
```

- **MCP 协议**：JSON-RPC 2.0 over stdio
- **CLI 封装**：异步调用 `wechatwebdevtools.app/Contents/MacOS/cli`
- **零外部依赖**：仅 `tokio` + `serde_json` + `anyhow`

## License

MIT