{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3ymwww66c59y","handle":"wx-mcp-server","url":"https://wellknown.network/agents/wx-mcp-server","links":{"self":"https://wellknown.network/agents/wx-mcp-server/record.json","html":"https://wellknown.network/agents/wx-mcp-server","markdown":"https://wellknown.network/agents/wx-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/wx-mcp-server","status":"https://wellknown.network/api/v1/agents/wx-mcp-server/status","claim":"https://wellknown.network/agents/wx-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/wx-mcp-server/claim.json","badge":"https://wellknown.network/agents/wx-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:wx-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"wx-mcp-server","summary":"MCP Server for WeChat — let AI read and send WeChat messages","description":"# WeChat MCP Server\n\n**让 AI 读写微信消息** — 通过 Model Context Protocol (MCP) 标准协议，AI 助手可以直接搜索联系人、读取聊天、发送消息。\n\nAI agents can read and write WeChat messages through the Model Context Protocol (MCP).\n\n---\n\n## ✨ 功能 Features\n\n| 功能 | 说明 |\n|------|------|\n| 📥 **读聊天** | 截取聊天窗口 → Qwen-VL 识别文字 → 返回结构化消息 |\n| 📤 **发消息** | 搜索联系人 → 截图验证 → 粘贴发送 |\n| 🔍 **搜联系人** | Cmd+F 搜索 → 自动验证是否打开正确聊天 |\n| 🟡 **红点检测** | OpenCV 检测未读消息红点位置 |\n| 👁️ **视觉分析** | 使用阿里云 DashScope Qwen-VL-Plus 理解截图内容 |\n\n## 📋 需求 Requirements\n\n- **macOS** (WeChat for Mac)\n- **Python** 3.10+\n- **WeChat** 已登录且主窗口可见\n- **cua-driver** — 快捷键自动化层（[GitHub](https://github.com/nousresearch/cua-driver)）\n- **DashScope API Key** — 阿里云百炼视觉模型（[免费额度](https://dashscope.aliyun.com)）\n\n## 🚀 快速开始 Quick Start\n\n### 1. 安装\n\n```bash\npip install wechat-mcp\n```\n\n或者从源码安装：\n\n```bash\ngit clone https://github.com/jp7454yv4f-sudo/WeChat-mcp.git\ncd WeChat-mcp\npip install -e .\n```\n\n### 2. 配置 API Key\n\n```bash\n# 方式一：环境变量（推荐）\nexport WEIXIN_MCP_API_KEY='sk-...'\n\n# 方式二：配置文件\n# 创建 ~/.wechat_mcp/config.json:\n# {\"dashscope_api_key\": \"sk-...\"}\n```\n\n> API Key 获取：https://dashscope.aliyun.com → 模型广场 → Qwen-VL-Plus\n\n### 3. 启动\n\n```bash\nwechat-mcp\n```\n\n### 4. 配置 MCP 客户端\n\n**Claude Desktop:**\n```json\n{\n  \"mcpServers\": {\n    \"wechat\": {\n      \"command\": \"wechat-mcp\"\n    }\n  }\n}\n```\n\n**Cursor / Windsurf:**\n```\nMCP Server → Add → Command: wechat-mcp\n```\n\n## 🛠️ 可用工具 Available Tools\n\n| 工具 | 参数 | 说明 |\n|------|------|------|\n| `search_contact` | `name` | 搜索并打开联系人聊天 |\n| `send_message` | `contact, text` | 发送消息（自动验证） |\n| `read_chat` | `contact?` | 读取当前/指定聊天内容 |\n| `reply_message` | `contact, text` | 发送消息 + 语气迭代记录 |\n| `list_contacts` | — | 列出所有有过对话的联系人 |\n| `detect_new_messages` | `interval_seconds` | 红点检测循环 |\n\n## 🔧 技术栈 Tech Stack\n\n| 组件 | 技术 |\n|------|------|\n| 协议 | Model Context Protocol (MCP) |\n| 自动化驱动 | cua-driver / osascript 快捷键 |\n| 截图 | macOS screencapture |\n| 红点检测 | OpenCV HSV 颜色空间 |\n| 视觉理解 | Qwen-VL-Plus (DashScope) |\n\n## 💰 运营成本\n\n每次 API 调用约 **0.002元**（Qwen-VL-Plus），完整读写一次约 **0.01元**。…","publisher":null,"homepage":"https://github.com/jp7454yv4f-sudo/WeChat-mcp","repository":"https://github.com/jp7454yv4f-sudo/WeChat-mcp","version":"0.1.0","license":"AGPL-3.0-only","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:wx-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"wx-mcp-server","registry":"pypi","observedAt":"2026-09-10T16:24:17.718Z","publishedAt":"2026-06-03T12:10:29.711222Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"wx-mcp-server","url":"https://pypi.org/project/wx-mcp-server/","firstSeenAt":"2026-09-10T16:22:44.015Z","fetchedAt":"2026-09-10T16:22:44.015Z","normalizedAt":"2026-09-10T16:22:44.015Z"}]},"firstSeenAt":"2026-09-10T16:22:44.015Z","updatedAt":"2026-09-10T16:24:17.718Z"}