Wechat Devtools Log MCP

微信开发者工具日志多进程通信（或“微信开发者工具日志MCP”）

大型语言模型（如Cursor、Claude Code等）代理的实时微信开发者工具日志流

 ](https://nodejs.org) ](https://www.python.org)

将您的微信小程序日志直接流式传输到您喜爱的由大型语言模型（LLM）支持的集成开发环境（IDE），享受AI辅助调试！

🚀 快速入门

1. 克隆此仓库

git clone https://github.com/your-org/wechat-devtools-log-mcp.git
cd wechat-devtools-log-mcp

2. 安装依赖项

make install

3. 将实用库复制到您的微信小程序

# Copy the mcp-logger folder to your WeChat project
cp -r utils/mcp-logger/ /path/to/your-wechat-miniapp/utils/

4. 在你的微信app.js文件中添加一行代码

// At the top of your app.js file
require('./utils/mcp-logger/index.js');

App({
  // ... your existing app code
});

5. 启动MCP服务

make start

6. 配置您的大型语言模型（LLM）代理

# For Cursor
make config-cursor

# For Claude Code
make config-claude

7. 完成！ 🎉

打开微信开发者工具，加载你的小程序，然后查看日志流向你的大型语言模型（LLM）代理！

✨ 特点

• 🔄 这个符号在中文中通常被翻译为“循环”或“旋转”。它表示一个动作、过程或状态在不断重复或持续进行。 实时日志流 - 立即向大型语言模型（LLM）代理交付日志
• 📋（清单/待办事项列表） 复制粘贴集成 - 只需将一个文件夹复制到您的项目中
• 🎯（目标） 零配置 - 开箱即用
• 🤖 机器人 大型语言模型（LLM）代理准备就绪 - 为Cursor、Claude Code预配置
• 🛡️ 翻译成中文是“盾牌”。 生产安全 - 在生产环境中自动禁用
• ⚡（闪电符号，常用于表示速度、活力或电力等概念，在此可直接保留原样或根据上下文意译为“快如闪电”等） 轻便型 - 最小化开销，异步日志记录
• 🔄 旋转（或循环） 网络韧性 - 重试逻辑和备用存储
• 📊（表格/数据图表） 健康监测 - 内置状态检查

📖 使用方法

基本命令

make start      # Start MCP services
make stop       # Stop services
make restart    # Restart services
make status     # Check service status
make logs       # View live logs
make test       # Test MCP connection

配置命令

make config-cursor  # Configure Cursor
make config-claude  # Configure Claude Code

🔧 工作原理

┌─────────────────┐
│ WeChat Mini-App │
│   (Your App)    │
└────────┬────────┘
         │ console.log()
         │ console.error()
         ↓
┌─────────────────┐
│  MCP Logger     │
│  (utils folder) │
└────────┬────────┘
         │ HTTP POST
         ↓
┌─────────────────┐
│  Log Server     │
│  (Port 3001)    │
└────────┬────────┘
         │ File Write
         ↓
┌─────────────────┐
│  MCP Server     │
│  (Port 8765)    │
└────────┬────────┘
         │ MCP Protocol
         ↓
┌─────────────────┐
│  LLM Agent      │
│ Cursor/Claude   │
└─────────────────┘

🛠️ 故障排除

日志未显示？

# Check service status
make status

# View live logs
make logs

# Test connection
make test

常见问题

“日志服务器未运行”

make restart

“权限被拒绝”

# Make sure ports 3001 and 8765 are available
lsof -i :3001
lsof -i :8765

“日志未流式传输到 Cursor”

# Reconfigure Cursor
make config-cursor
# Restart Cursor

📚 文档

• HOWTO.md 翻译为中文是：“如何操作指南.md”（其中，“.md”通常表示Markdown文件格式） - 详细的设置指南
• docs/prd.md 翻译为中文是：“文档/产品描述文件（Markdown格式）”。不过，这里的“docs/prd.md”通常是一个文件路径，直接翻译可能不太符合中文表达习惯，更自然的表达可能是“位于docs目录下的prd.md文件（Markdown格式的产品文档）”。但考虑到简洁性，通常直接说“docs/prd.md（Markdown格式的产品文档）”即可 - 产品需求文档
• docs/frontend-setup.md 翻译为中文是：“文档/前端设置指南.md” 或者 “前端配置文档.md”（具体翻译可能根据上下文有所调整，但基本意思是指一个关于前端设置或配置的Markdown文档文件） - 前端集成详情
• docs/troubleshooting.md 翻译为中文是：文档/故障排除.md - 常见问题
• 文档/api参考.md API文档

🤝 贡献

我们欢迎投稿！请参阅 CONTRIBUTING.md 翻译为中文是：“贡献指南/贡献说明文件”。

📄 许可证

MIT 许可证 - 详见 许可证 文件中详述。

💬 支持

• 📖 书籍 文档
• 🐛 表示“虫子”或“小故障/问题”（在互联网俚语中，常用来比喻软件或系统中的小错误或漏洞）。 问题追踪器
• 💬（这个表情符号通常表示“对话气泡”或“聊天”，在中文中没有直接对应的翻译，但可以理解为“说”或“聊天”的意思，具体翻译可能根据上下文有所不同。）

______________________________________________________________________

专为使用大型语言模型（LLM）代理的微信小程序开发者打造，倾注爱心