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: weapp-agent-mcp
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.
Appeared in Searches
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- 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