Skip to main content
Glama
Is-JunZe

QQ MCP Server

by Is-JunZe
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

QQ MCP Server

通过 Claude Code 自动发送 QQ 消息的 MCP 插件。基于 Windows UI 自动化（pywinauto），无需 QQ Bot API。

⚙️ 环境要求

项目

要求

操作系统

Windows 10 / 11（macOS / Linux 不支持）

QQ

桌面版已安装并保持登录状态

Python

>= 3.10

Related MCP server: claude-computer-use-mcp

📦 安装

方式一：Claude Code 插件安装（推荐）

# 从 GitHub 安装
claude plugins install github.com/<your-username>/qq-mcp-plugin

方式二：手动安装

# 1. 克隆仓库
git clone https://github.com/<your-username>/qq-mcp-plugin.git
cd qq-mcp-plugin

# 2. 安装依赖
pip install -r requirements.txt

# 3. 注册到 Claude Code
claude mcp add qq -- python "C:/path/to/qq-mcp-plugin/server.py"

🛠️ 可用工具

qq_send_message

发送消息给 QQ 好友。

参数

类型

说明

friend

string

QQ 好友昵称（支持模糊匹配）

message

string

消息内容

qq_check_status

检查 QQ 是否在线、自动化是否可用。

🔧 工作原理

Claude Code → MCP stdio → server.py
                              │
                    ┌─────────┴─────────┐
                    │  pywinauto (UIA)  │
                    │  定位 QQ 主窗口    │
                    └─────────┬─────────┘
                              │
              ┌───────────────┴───────────────┐
              │  Ctrl+F → 搜索好友 → Enter    │
              │  Ctrl+V → 粘贴消息 → Enter    │
              └───────────────────────────────┘

关键提示： QQ 窗口必须保持打开且可见，不能被最小化到系统托盘。发送期间请勿操作键盘鼠标，避免干扰自动化流程。

🐛 常见问题

Q: 提示 "QQ 窗口未找到"？

  • 确认 QQ 已登录且主窗口可见

  • 检查窗口标题是否为 "QQ"（某些修改版 QQ 标题不同）

Q: 消息发给了错误的人？

  • 昵称使用模糊匹配，若有多人昵称相似可能匹配到第一人

  • 建议使用更精确的昵称

Q: 发送失败 / 卡住？

  • 增大 server.py 中 time.sleep() 的等待时间（电脑响应慢时）

  • 确保没有其他窗口抢占焦点

📄 License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • WinAutoWx

    pmhw
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables automated WeChat operations on Windows through pywinauto, allowing users to send messages to multiple friends or groups programmatically. Provides tools for searching contacts, sending bulk messages, and controlling WeChat interface elements via MCP protocol.
    17
    -

  • claude-computer-use-mcp

    cUDGk
    A
    license
    Not graded
    quality
    B
    maintenance
    Wraps OpenAI Codex's computer-use engine to provide MCP tools for Windows screen operations including screenshot, UI automation tree, and input simulation, enabling Claude Code to control the desktop.
    35
    MIT

  • autoit-mcp

    benina
    F
    license
    Not graded
    quality
    C
    maintenance
    Windows GUI automation MCP server for Claude Code, enabling deterministic desktop app control via 32 tools including window management, input, pixel search, and file verification, leveraging the AutoIt backend.
    -

Latest Blog Posts

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/Is-JunZe/qq-mcp-plugin'

If you have feedback or need assistance with the MCP directory API, please join our Discord server