stkoecn/im-mcp

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

72 stars 38 forks Quality 76 Trend 37

Repository Install

Fast, local, read-only MCP Server for WeChat (4.x/3.x) & DingTalk (7.x V2/V3) chat history with FTS5 search

Overview

A standardized local IM (Green Bubble & DuangDuang) chat history and address book retrieval service. Extremely simple, read-only, fully offline local operation, enabling AI agents like Claude Desktop, Cursor, Cline, Pi, and others to safely and quickly retrieve and summarize your work communications, group chat records, and knowledge base. Note: The original underlying reference projects are uniformly archived in the reference/ directory as Git Submodules (reference/wechat-local-viewer and reference/dingwave-V3). - ⚡ : Directly decrypts SQLite databases locally, millisecond-level response. - 🔒 : All data is local, never cloud-based; Runs in read-only mode without corrupting original data. - 📦 : One repository, two independent entry points; Supports installing only Green Bubble, DuangDuang, or full installation. - 💬 : - Supports regular text, quoted messages, rich text cards, mini programs, file transfers (PDF/Excel/Word, etc.). - : Supports multi-table fragmented aggregation (tbmsg_000~tbmsg_127), contact real-name mapping, Markdown cards, collaborative schedule notifications, file attachment extraction. A total of 29 tools, all read-only (sync_wechat_database / start_sync / set_auto_sync trigger local snapshot reconstruction, but do not send any messages to WeChat). This project fully follows the PEP 517 / 621 standard packaging, native support, and pip, eliminating manual virtual environment and path configuration. Using the uv tool creates an independent, managed persistent runtime environment for the tool and registers the CLI to the system's global path: UVX is suitable for one-time temporary experiences or scenarios where you don't want to install it permanently (there may be version check overhead each time; In domestic environments, it can be replaced with git+https://gitee.com/ws4m/im-mcp.git[all]）： This project fully defines the full automated operation and maintenance specifications (covering **) for AI Agents across various platforms (Pi, Claude Desktop/Code, Cursor, Cline, etc.) in skills/im-mcp/SKILL.md.

Overview (machine translated)

A local IM (Green Bubble & DuangDuang) chat record and address book retrieval service built on the Model Context Protocol (MCP) specification. Minimalist, read-only, fully offline local operation allows AI Agents like Claude Desktop, Cursor, Cline, Pi, and others to safely and quickly retrieve and summarize your work communications, group chat records, and knowledge base.

💡 > Copy-and-Use Prompt (sent directly to your AI Agent / client):

Note: The original underlying reference projects are uniformly archived in the reference/ directory (reference/wechat-local-viewer and reference/dingwave-V3) as Git Submodules.

✨ Core Features

⚡ Ultra-low latency: Directly decrypts SQLite databases locally, millisecond-level response.
🔒 Pure Local vs. Read-Only: All data is local, never cloud-based; Runs in read-only mode without damaging the original data.
📦 Optional Dependencies: One warehouse, two independent entrances; Supports installing only Green Bubble, DuangDuang, or full installation.
💬 Rich Format Analysis:
Green Bubble: Supports regular text, quoted messages, rich text cards, mini programs, and file transfers (PDF/Excel/Word, etc.).
DuangDuang: Supports multi-table shard aggregation (tbmsg_000~tbmsg_127), contact real-name mapping, Markdown cards, collaborative schedule notifications, and file attachment extraction.

🔍 Supported Client and System Versions (Compatibility)

Platform	Supported version range	Tested version verification	Architecture and platform	Decryption / synchronization principles
Green Bubble (WeChat)	Green Bubble 4.x Full Series (Compatible with 3.9.x)	`4.1.15.13` (Windows Latest Version) `4.1.35.15` (macOS ARM64 Latest Version) `4.1.15` (270115) (Tested and Verified on macOS x86_64) `4.1.11.x` etc.	Windows x64 macOS (Apple Silicon & Intel)	Windows: Runtime scans `Weixin.exe` Config.Cipher dynamically extracts Salt keys; macOS: Native `CommonCrypto` (CCCrypt) zero dependency decryption, supports passphrase PBKDF2 derivation; Offline HMAC validation and decryption of WCDB SQLite
DuangDuang (DingTalk)	**DuangDuang 7.

This page was translated automatically. Technical details may differ from the original.

Install

uvx --from git+https://github.com/stkoecn/im-mcp.git[all

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "wechat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/stkoecn/im-mcp.git[all]",
        "wechat-mcp"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8",
        "PYTHONUTF8": "1"
      },
      "description": "绿泡泡聊天记录与群聊检索 MCP"
    },
    "dingtalk": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/stkoecn/im-mcp.git[all]",
        "dingtalk-mcp"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8",
        "PYTHONUTF8": "1"
      },
      "description": "DuangDuang聊天记录、群聊与通讯录检索 MCP"
    }
  }
}