wechat-miniapp-engineering-mcp
This server is a WeChat Mini Program engineering advisor that acts as a project coach, helping developers analyze projects, generate blueprints, break down work, and prepare for launch. Key capabilities include:
Project Inspection (
miniapp_inspect_project): Scan a local project to explain pages, tabBar, cloud functions, business modules, and suggest next steps.Blueprint Generation (
miniapp_generate_blueprint): Create a full engineering blueprint covering product positioning, pages, data collections, cloud functions, UI, and launch plan.Showcase Roadmap (
miniapp_showcase_roadmap): Generate a beginner-friendly roadmap for a customer showcase Mini Program, covering MVP scope, SOPs, pages, data, CloudBase, privacy, and launch checklist.Work Breakdown (
miniapp_work_breakdown): Decompose features into requirements, UI, frontend, backend, QA, and launch tasks.Dev Recovery Playbook (
miniapp_dev_recovery_playbook): Provide a fault recovery handbook for common issues like session state, missing page files, cloud function routing/deployment, DevTools EISDIR errors, and version release.Release Preflight (
miniapp_cloudbase_release_preflight): Generate pre-release checklists for cloud function deployment, Mini Program upload/review, and NPM/GitHub sync.Launch Checklist (
miniapp_launch_checklist): Generate a comprehensive pre-launch checklist covering cloud dev, privacy, review materials, and private album delivery.Project Map (
miniapp_project_map): Generate a knowledge graph of pages, files, cloud functions, data collections, and dependency edges.File Role Understanding (
miniapp_understand_file_role): Explain a specific file's role, upstream/downstream relationships, and recommended next steps.Feature Impact Analysis (
miniapp_understand_feature_impact): Analyze which pages, cloud functions, data collections, permissions, tests, and risks are affected by a feature.Relevant Context (
miniapp_relevant_context): Collect Core/Near/Extended/Background four-tier engineering context for a given task or query.Dependency Diagram (
miniapp_dependency_diagram): Generate Mermaid dependency diagrams for pages, routes, cloud functions, controllers, and collections.Graph Stats (
miniapp_graph_stats): Output code graph statistics including node/edge types, route chains, key nodes, and risk alerts.Index Status (
miniapp_index_status): Calculate file hashes and report added/changed/removed files compared to local cache.Security Quick Scan (
miniapp_security_quick_scan): Scan for sensitive keys, secret logs, database permissions, cloud storage access, privacy fields, and test residuals — without exposing raw sensitive content.Docs Lookup (
miniapp_docs_lookup): Query a local index of WeChat Mini Program official docs, GitHub projects, and engineering tools.CloudBase MCP Guide (
miniapp_cloudbase_mcp_guide): Output guidance on combining CloudBase MCP with this local engineering advisor.Project Flow Understanding (
miniapp_understand_project_flow): Explain the complete engineering flow from requirements → UI → frontend → backend → data → testing → launch.Optimization Log Management (
local_mcp_append/read/status_optimization_log): Append, read, and check the status of local MCP optimization logs to track improvements and decisions.
Provides tools for WeChat mini-program engineering, including project inspection, blueprint generation, roadmap creation, work breakdown, recovery playbook, release preflight checks, launch checklists, project mapping, security scanning, and more.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wechat-miniapp-engineering-mcpScan my WeChat mini program project for security issues."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
面向中国友好的微信小程序开发 MCP
一个中文优先、本地运行的微信小程序工程顾问 MCP,立志让每个小白都可以轻松上手。
它不是页面模板库,也不是自动部署器。它更像一个工程教练:把一个微信小程序从想法拆成需求、页面、数据、云函数、CloudBase、安全、测试、上线和后续优化。
项目状态
当前版本:
0.6.0运行方式:本地 stdio MCP server
目标用户:中国微信小程序开发者、AI IDE 用户、刚开始做小程序的产品/运营/个体商家
默认示例:包内 synthetic 微信小程序 fixture,不包含真实客户资料、真实 AppID、真实云存储 fileID 或密钥
安全边界:默认不联网、不部署、不写真实 CloudBase/Tencent 环境、不保存密钥
Related MCP server: My MCP Server
Codex Skill 版本
如果你主要在 Codex 里使用微信小程序工程经验,推荐使用新版 Skill 仓库: wechat-miniapp-engineering-skill。
Skill 版本把本 MCP 的工程经验、工作流、检查清单和离线演示工具打包成 Codex 可直接安装的能力包;本仓库仍保留原 stdio MCP server,适合需要接入 MCP 客户端的场景。
核心能力
扫描本地微信原生/云开发小程序工程,解释页面、tabBar、云函数、业务模块和下一步建议。
生成微信小程序工程蓝图:产品定位、页面、数据集合、云函数、UI、测试和上线。
输出“客户成片展示小程序”小白路线图:业务定位、MVP 边界、阶段 SOP、页面、数据、CloudBase、隐私和上线清单。
把功能拆成需求、UI、前端、后端、测试、上线任务。
固化小程序开发故障恢复手册,覆盖会话恢复、页面四件套、云函数路由/部署、DevTools EISDIR、版本发布和外发确认。
生成云函数、小程序上传/审核、NPM/GitHub 同步前的发布预检清单。
生成小程序上线检查清单,重点覆盖隐私、云存储、数据库规则和审核材料。
生成轻量项目地图、文件角色解释、功能影响分析、相关上下文和 Mermaid 依赖图。
做小程序专项安全快扫,只输出路径、行号、规则和修复方向,不输出原始敏感匹配文本。
维护 MCP 优化日志,并可同步生成脱敏公开版
CHANGELOG.md和小白友好版创建说明书。
快速开始
要求 Node.js >=18。
git clone https://github.com/lychee20000105/wechat-miniapp-engineering-mcp.git
cd wechat-miniapp-engineering-mcp
npm run smoke:test启动本地 MCP server:
npm run start这个 server 使用 stdio MCP。通常不需要手动长期运行,MCP 客户端会按配置自动启动。
MCP 客户端配置
把下面配置加到支持 MCP 的客户端里,并把 /absolute/path/to/wechat-miniapp-engineering-mcp 替换成你的本地项目绝对路径。
{
"mcpServers": {
"wechat-miniapp-engineering": {
"command": "node",
"args": [
"/absolute/path/to/wechat-miniapp-engineering-mcp/src/server.js"
]
}
}
}如果你要让 AI 同时管理真实 CloudBase 环境,可以另外配置官方 CloudBase MCP。本项目只负责工程规划、项目理解和上线检查,不直接替代官方部署工具。
常用工具
工具 | 用途 |
| 扫描本地小程序工程,解释页面、云函数和业务模块 |
| 生成小程序产品到工程的完整蓝图 |
| 生成客户成片展示小程序的小白路线图 |
| 把功能拆成需求、UI、前端、后端、测试、上线任务 |
| 生成小程序开发故障恢复手册 |
| 生成云函数/小程序/NPM/GitHub 发布前预检清单 |
| 生成上线前检查清单 |
| 输出页面、云函数、集合、组件和依赖边 |
| 解释某个文件的角色、上下游和下一步 |
| 分析一个功能影响哪些页面、接口、数据和上线风险 |
| 按 Core/Near/Extended/Background 收集相关上下文 |
| 生成 Mermaid 依赖图 |
| 做小程序专项安全快扫 |
| 计算安全文本文件 hash,默认只读 |
| 追加本地 MCP 优化日志 |
| 读取最近的 MCP 优化日志 |
| 查看日志路径、记录数和最新摘要 |
资源与提示词
内置资源包括:
miniapp://docs/indexminiapp://project/currentminiapp://checklists/launchminiapp://roadmap/showcaseminiapp://playbooks/dev-recoveryminiapp://checklists/cloudbase-releaseminiapp://cloudbase/mcp-guideminiapp://audit/optimization-logminiapp://audit/optimization-log/latestminiapp://understand/project-mapminiapp://understand/project-flowminiapp://understand/relevant-contextminiapp://understand/dependency-diagramminiapp://audit/security-quick-scanminiapp://understand/index-status
内置提示词包括:
miniapp_product_managerminiapp_engineering_reviewerminiapp_xiaoli_engineering_planner
冒烟测试
npm run smoke:test通过时会看到类似:
{
"initialize": true,
"toolCount": 25,
"resourceCount": 20,
"promptCount": 3,
"showcaseRoadmapReturnedText": true,
"invalidEnumRejected": true,
"missingRequiredRejected": true
}默认 smoke test 使用包内 synthetic fixture:
data/fixtures/demo-miniapp如需验证其他本地小程序项目,可以临时设置:
SMOKE_PROJECT_PATH=/absolute/path/to/your-miniapp npm run smoke:test真实项目扫描前,请先确认隐私范围,不要把真实密钥、客户素材、手机号、订单号或云存储 fileID 写进日志。
更新日志同步
项目维护时,内部优化日志会追加到:
logs/mcp-optimization-log.jsonl
logs/mcp-optimization-log.md这两份原始日志默认不提交到 GitHub。公开项目说明使用脱敏后的 CHANGELOG.md,同时同步 README 最近更新摘要和 MCP 详细创建说明书:
npm run changelog:sync同步规则:
从内部 JSONL 日志提取版本、摘要、变更文件、验证结果和安全边界。
自动脱敏本机路径、手机号、密钥形态、真实云存储路径和本地知识库描述。
不同步隐藏推理、客户原文、密钥、token、订单号、手机号或真实 fileID。
后续每次追加内部优化日志后,先运行
npm run changelog:sync,再提交 README、CHANGELOG.md和docs/mcp-creation-guide.md。
最近更新
2026-06-07
v0.6.0:完成 v0.6.0 开发复盘沉淀:新增小程序故障恢复手册和云函数/小程序/NPM/GitHub 发布前预检工具。2026-06-07
v0.5.2:完成 v0.5.2 文档同步升级:新增小白友好版 MCP 详细创建说明书,并纳入 changelog:sync 自动更新流程。2026-06-07
v0.5.1:完成 v0.5.1 开源准备:整理中文 GitHub README、MIT 许可证、公开脱敏 CHANGELOG 同步机制、通用默认配置和发布前安全忽略规则。2026-06-07
v0.5.0:完成 v0.5.0 优化:新增客户成片展示小程序路线图工具与资源,并加入轻量参数校验和 JSON-RPC 错误码分类。2026-06-07
v0.4.1:完成 v0.4.1 小步可验证优化:强化 realpath 路径安全、包内 synthetic fixture 验证、WXML/WXSS/JSON 组件关系识别、上线安全快扫规则和日志 outcome 字段。
完整公开更新日志见 CHANGELOG.md。
安全边界
不保存 AppSecret、腾讯云 SecretKey、后台密码、Webhook、token、Cookie 或私钥。
默认只读扫描项目;
miniapp_index_status只有传writeCache: true时才写入本项目cache/。项目理解工具只读取安全文本文件,跳过
.env、密钥、token、历史记录、私密配置、备份 JSON 和高风险目录。路径解析使用 realpath 校验并跳过软链接,防止
..、绝对路径或软链接逃逸到项目外。安全快扫不输出原始敏感匹配文本,只输出路径、行号、规则、严重级别和修复方向。
真实云开发环境操作建议另配官方 CloudBase MCP,并在上传、改权限、改正式数据前人工确认。
开发脚本
npm run start
npm run smoke:test
npm run changelog:sync语法检查:
node --check src/server.js
node --check scripts/smoke-test.js
node --check scripts/sync-public-changelog.js许可证
MIT
版本档案 / Release History
本项目后续更新默认保留历史文案,不覆盖原始上传内容。每个有意义的版本都会优先通过以下位置叠加记录:
GitHub Releases:https://github.com/lychee20000105/wechat-miniapp-engineering-mcp/releases
CHANGELOG.md
docs/releases/
README 只保留当前版本入口和必要说明;历史版本细节按版本向上叠加,方便像 release 页面一样查看完整演进记录。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/lychee20000105/wechat-miniapp-engineering-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server