{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6tzbpy7jk4q9","handle":"wxauto-mcp","url":"https://wellknown.network/agents/wxauto-mcp","links":{"self":"https://wellknown.network/agents/wxauto-mcp/record.json","html":"https://wellknown.network/agents/wxauto-mcp","markdown":"https://wellknown.network/agents/wxauto-mcp/record.md","api":"https://wellknown.network/api/v1/agents/wxauto-mcp","status":"https://wellknown.network/api/v1/agents/wxauto-mcp/status","claim":"https://wellknown.network/agents/wxauto-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/wxauto-mcp/claim.json","badge":"https://wellknown.network/agents/wxauto-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:wxauto-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"wxauto-mcp","summary":"wxauto automation MCP Server for AI development tools","description":"# wxauto MCP Server\n\n微信自动化 MCP (Model Context Protocol) 服务器，为 AI 开发工具提供微信自动化能力。\n\n[![Python Version](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-1.0+-orange.svg)](https://modelcontextprotocol.io/)\n\n## 功能特性\n\n- **MCP 协议支持**: 完整支持 Model Context Protocol\n- **消息操作**: 发送文本、图片、文件、链接卡片消息\n- **联系人管理**: 获取好友列表、切换聊天、获取聊天信息\n- **会话管理**: 获取会话列表、筛选未读消息\n- **文件传输**: 发送单个或批量文件\n- **好友管理**: 获取新好友请求、接受好友、添加新好友\n- **多种传输**: 支持 stdio、HTTP/SSE 传输方式\n- **AI 工具集成**: 支持 Claude Code、Cursor 等开发工具\n- **一键安装**: 自动配置到 AI 应用，无需手动编辑配置文件\n- **全局单例**: 自动检测并复用已运行的服务器实例，避免资源浪费和冲突\n\n## 系统要求\n\n- Windows 11/10\n- Python 3.11+\n- 微信已登录\n- wxautox4 激活\n\n## PyPI 自动发布\n\n本项目已配置 PyPI Publishing，推送版本标签即可自动发布：\n\n```bash\n# 发布新版本\ngit tag v1.0.1\ngit push origin v1.0.1\n```\n\nGitHub Actions 会自动构建并创建 Release，PyPI 会自动发布新版本。\n\n## 快速安装\n\n```bash\npip install wxauto-mcp\n```\n\n## 使用\n\n### 一键自动安装（推荐）\n\n```bash\nwxauto-mcp --install\n```\n\n这将自动配置 MCP Server 到 **Claude Desktop** 和 **Claude Code**，无需手动编辑配置文件。\n\n### 生成配置文件\n\n```bash\n# 生成配置文件到默认目录 (./mcp-configs)\nwxauto-mcp --config\n\n# 生成配置文件到指定目录\nwxauto-mcp --config /path/to/configs\n```\n\n### 手动配置\n\n如果需要手动配置，运行：\n\n```bash\nwxauto-mcp --config mcp-configs\n```\n\n然后将生成的配置文件内容添加到 AI 应用中：\n\n**Claude Desktop** 配置文件位置：\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**Claude Code** 配置文件位置：\n- `%USERPROFILE%\\.claude.json`\n\n**Cursor**：在 Settings 的 MCP 配置中添加\n\n### 启动服务器\n\n```bash\n# stdio 模式 (默认，用于 MCP 客户端)\nwxauto-mcp\n\n# HTTP/SSE 模式\nwxauto-mcp-http --port 8000\n\n# 指定主机和端口\nwxauto-mcp-http --host 0.0.0.0 --port 9000\n```\n\n## 可用工具（27个）\n\n### 系统工具（6个）\n- `wechat_initialize` - 初始化微信连接\n- `wechat_status` - 获取微信运行状态\n- `wechat_activate` - 激活 wxautox4\n- `wechat_check_activation` - 检查激活状态\n- `wechat_list_tools` - 列出所有可用工具\n- `get_my_info` - 获取我的微信账号信息\n\n### 消息工具（6个）\n- `send_message` - 发送文本消息\n- `send_url_card` - 发送链接卡片\n- `get_messages` - 获取当前聊天消息\n- `get_history` - 获取历史消息\n- `ge…","publisher":{"name":"wxauto MCP Team","url":null},"homepage":"https://github.com/wxauto-mcp/wxauto-mcp#readme","repository":"https://github.com/wxauto-mcp/wxauto-mcp#readme","version":"1.0.2","license":"MIT","protocols":["mcp"],"tags":["ai","automation","mcp","wechat","wxauto","wxautox4"],"pricing":null,"endpoints":[{"url":"pypi:wxauto-mcp","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","publisherName":"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":"wxauto-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:17.580Z","publishedAt":"2026-03-09T12:22:38.124678Z","latestVersion":"1.0.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"wxauto-mcp","url":"https://pypi.org/project/wxauto-mcp/","firstSeenAt":"2026-09-10T16:22:43.520Z","fetchedAt":"2026-09-10T16:22:43.520Z","normalizedAt":"2026-09-10T16:22:43.520Z"}]},"firstSeenAt":"2026-09-10T16:22:43.520Z","updatedAt":"2026-09-10T16:24:17.580Z"}