What can you do with this server?

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.

Which integrations are available for this server?

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.

How do I use wechat-miniapp-engineering-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@wechat-miniapp-engineering-mcp Scan 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.

wechat-miniapp-engineering-mcp

by lychee20000105

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

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.

面向中国友好的微信小程序开发 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。本项目只负责工程规划、项目理解和上线检查，不直接替代官方部署工具。

常用工具

工具	用途
`miniapp_inspect_project`	扫描本地小程序工程，解释页面、云函数和业务模块
`miniapp_generate_blueprint`	生成小程序产品到工程的完整蓝图
`miniapp_showcase_roadmap`	生成客户成片展示小程序的小白路线图
`miniapp_work_breakdown`	把功能拆成需求、UI、前端、后端、测试、上线任务
`miniapp_dev_recovery_playbook`	生成小程序开发故障恢复手册
`miniapp_cloudbase_release_preflight`	生成云函数/小程序/NPM/GitHub 发布前预检清单
`miniapp_launch_checklist`	生成上线前检查清单
`miniapp_project_map`	输出页面、云函数、集合、组件和依赖边
`miniapp_understand_file_role`	解释某个文件的角色、上下游和下一步
`miniapp_understand_feature_impact`	分析一个功能影响哪些页面、接口、数据和上线风险
`miniapp_relevant_context`	按 Core/Near/Extended/Background 收集相关上下文
`miniapp_dependency_diagram`	生成 Mermaid 依赖图
`miniapp_security_quick_scan`	做小程序专项安全快扫
`miniapp_index_status`	计算安全文本文件 hash，默认只读
`local_mcp_append_optimization_log`	追加本地 MCP 优化日志
`local_mcp_read_optimization_log`	读取最近的 MCP 优化日志
`local_mcp_optimization_log_status`	查看日志路径、记录数和最新摘要

资源与提示词

内置资源包括：

miniapp://docs/index
miniapp://project/current
miniapp://checklists/launch
miniapp://roadmap/showcase
miniapp://playbooks/dev-recovery
miniapp://checklists/cloudbase-release
miniapp://cloudbase/mcp-guide
miniapp://audit/optimization-log
miniapp://audit/optimization-log/latest
miniapp://understand/project-map
miniapp://understand/project-flow
miniapp://understand/relevant-context
miniapp://understand/dependency-diagram
miniapp://audit/security-quick-scan
miniapp://understand/index-status

内置提示词包括：

miniapp_product_manager
miniapp_engineering_reviewer
miniapp_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。

安全边界

不保存 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 页面一样查看完整演进记录。

Available Tools

25 tools

local_mcp_append_optimization_logB

追加 MCP 优化日志，记录用户思路、Codex 决策摘要、引用技能、文件改动、验证结果和安全边界。

Inputs: roundType, outcome, actor, summary, +9 more.

local_mcp_optimization_adviceA

基于本地 Codex/Claude 文档和当前小程序工程，输出这个 MCP 的优化建议。

Inputs: target.

local_mcp_optimization_log_statusA

查看 MCP 优化日志状态、路径、记录数和强制记录规则。

Inputs: no named parameters.

local_mcp_read_optimization_logA

读取 MCP 优化日志，默认返回最近 10 条 Markdown 记录。

Inputs: limit, format.

local_skill_routingB

根据已安装 Codex/Claude/agents 技能，输出适合小程序工程的技能路由和使用建议。

Inputs: topic.

local_user_profileB

读取本地规则后提炼的工作画像，包括沟通、交付、安全、知识库和编码习惯。

Inputs: includeSources.

miniapp_cloudbase_mcp_guideA

输出 CloudBase MCP 与本地小程序工程顾问 MCP 的组合使用说明和安全边界。

Inputs: no named parameters.

miniapp_cloudbase_release_preflightB

生成云函数部署、小程序上传/审核发布、NPM/GitHub 同步前的确认清单，避免环境、版本、打包和外发范围出错。

Inputs: action, cloudFunctionName, envId, version, +2 more.

miniapp_dependency_diagramB

生成小程序页面、文件、路由、云函数、controller、集合之间的 Mermaid 依赖图。

Inputs: projectPath, target, featureName, limit.

miniapp_dev_recovery_playbookA

把微信小程序开发中的常见故障复盘成恢复手册，覆盖会话错乱、页面四件套、云函数路由、DevTools EISDIR、版本发布和外发确认。

Inputs: topic, includeCaseStudy.

miniapp_docs_lookupA

按主题查询本地整理的小程序官方文档、GitHub 项目和工程工具索引。

Inputs: topic.

miniapp_generate_blueprintC

为一个微信小程序产品生成从产品定位、页面、数据表、云函数、UI 到上线的工程蓝图。

Inputs: productName, brandName, depth, linkExistingProject.

miniapp_graph_statsB

输出小程序轻量代码图谱统计：节点/边类型、route 链路、重要节点和风险提示。

Inputs: projectPath, limit.

miniapp_index_statusB

融合 CodeGraph 增量索引思路，计算安全文本文件 hash，报告与本地 cache 的新增/变化/移除状态。

Inputs: projectPath, limit, writeCache.

miniapp_inspect_projectA

扫描本地微信原生/云开发小程序工程，输出页面、tabBar、云函数、业务模块和下一步建议。

Inputs: projectPath, includeReadme.

miniapp_launch_checklistB

生成微信小程序上线前检查清单，包含云开发、隐私、审核、客户私密相册交付。

Inputs: includePrivateAlbum.

miniapp_project_mapC

借鉴 Understand-Anything 的知识图谱思路，生成本地小程序项目地图：页面、文件、云函数、集合和依赖边。

Inputs: projectPath, limit, format, detail_level.

miniapp_relevant_contextB

融合 CodeGraph 的 4-tier context 思路，按任务输出 Core/Near/Extended/Background 四层小程序工程上下文。

Inputs: projectPath, query, goal, featureName, +3 more.

miniapp_security_quick_scanB

小程序上线专项安全快扫，检查密钥字段、敏感日志、数据库权限、云存储访问、云函数权限、隐私字段、测试残留和配置边界。

Inputs: projectPath, limit, maxFindings.

miniapp_showcase_roadmapB

为客户成片展示小程序输出小白可执行路线图：业务定位、MVP 边界、阶段 SOP、页面、数据、CloudBase、隐私和上线清单。

Inputs: brandName, depth, phase, audience.

miniapp_understand_feature_impactB

输入一个功能名，分析可能影响的页面、云函数、数据集合、权限、测试和上线风险。

Inputs: projectPath, featureName, limit.

miniapp_understand_file_roleB

解释某个项目内文件在微信小程序工程里的角色、上下游线索和小白下一步。

Inputs: filePath (required), projectPath, focus.

miniapp_understand_project_flowC

面向小白解释一个小程序从需求、UI、前端、后端、数据、测试到上线的完整工程流程。

Inputs: projectPath, goal, limit.

miniapp_work_breakdownC

把功能拆成需求、UI、前端、后端、测试、上线六类任务清单。

Inputs: featureName, phase.

yunyu_query_contextC

调用本机本地知识库路由检索，读取和当前小程序/业务相关的上下文。

Inputs: query, confirmed.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

B3.1/5.0

Scored 2026-06-07 21:10 across 25 tools

Disambiguation3/5

Many tools have distinct purposes, but miniapp_project_map, miniapp_dependency_diagram, and miniapp_graph_stats overlap significantly as they all analyze project structure and dependencies. This creates ambiguity for an agent deciding which tool to use.

Naming Consistency3/5

Naming uses snake_case with consistent prefixes (local_mcp_, miniapp_), but the verb-noun pattern is inconsistent: some tools start with verbs (generate, inspect, understand) while others are nouns (project_map, launch_checklist). This mixed pattern reduces predictability.

Tool Count4/5

With 25 tools, the server covers a broad range of miniapp engineering tasks from optimization logging to security scanning. While slightly on the high side, the count is justified by the variety of functionalities and is not excessive.

Completeness4/5

The tool set covers most advisory and analysis needs for miniapp engineering, including inspection, dependency analysis, security scanning, blueprint generation, and context retrieval. The lack of tools for actually modifying project files is a minor gap, but likely intentional as a read-only advisor.

Maintenance

ActivityNo data

ResponsivenessOutdated data

Resources

Related MCP Connectors

Tinplate Edge AI Safety, Security & EU ComplianceB
dev.tinplate
Zero-log MCP server with 49 tools for AI guardrails, secret scanning, MCP linting & EU compliance.
491
https://api.tinplate.dev/mcp
neverinfamous-memory-journal-mcp
ai.smithery
A MCP server built for developers enabling Git based project management with project and personal…
Version Control Developer Tools Project Management
320
https://server.smithery.ai/@neverinfamous/memory-journal-mcp/mcp
Toolkien
io.github.epavanello
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Developer Tools Security
1
https://toolkien.dev/mcp
PlanExeADeprecated
io.github.PlanExeOrg
MCP server for generating rough-draft project plans from natural-language prompts.
Autonomous Agents Developer Tools Project Management
3403
https://mcp.planexe.org/mcp

Related MCP Servers

harmony-mcp
Developer Tools CI/CD & DevOps
xiaoxuzhu303-prog
A
license
Not graded
quality
B
maintenance
An MCP server that enables AI assistants to interact with WeChat Mini Programs, allowing developers to publish versions, analyze package size, diagnose compilation errors, and manage projects via natural language.
Updated 5 months ago (2026-06-18 06:28 UTC)
78 npm
3
MIT
weapp-agent-mcp
Testing & QA Tools App Automation Agent Orchestration
Chaixueyuan
A
license
A
quality
C
maintenance
MCP server for WeChat Mini Program debugging and automation, enabling agents to perform UI operations, screenshots, and regression testing through natural language commands.
Updated 4 months ago (2026-07-01 08:00 UTC)
44
107 npm
23
MIT
MCP-WEDECODEMCP
Code Analysis File Systems
d-rn
A
license
Not graded
quality
D
maintenance
A WeChat Mini Program decompilation MCP server that enables scanning, decompiling, and analyzing local WeChat mini program packages through MCP clients like Cherry Studio.
Updated 7 months ago (2026-04-01 20:03 UTC)
4
GPL 3.0
Cocos Creator Local MCP
Developer Tools Coding Agents
lightblink
A
license
A
quality
D
maintenance
An MCP server for local Cocos Creator 3.8 automation, enabling coding agents to create projects, edit scenes, and build WeChat Mini Games directly on a developer machine.
Updated 4 months ago (2026-07-01 15:47 UTC)
19
3
MIT

Appeared in Searches

A guide for developing WeChat Mini Programs