MCPgee
MCPgee
MCPgeeMCPgee

Weilink

v1.0.0•Communication•stable

Zero-dependency Python SDK for WeChat Bot (iLink protocol) — text, image, video messaging & MCP server | 零依赖微信机器人 Python SDK，支持多媒体消息和 MCP 服务器

ai-agentbotchatbotilinkilink-bot
Share:
13
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Weilink?

Weilink is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to zero-dependency python sdk for wechat bot (ilink protocol) — text, image, video messaging & mcp server | 零依赖微信机器人 python sdk，支持多媒体消息和 mcp 服务器

Zero-dependency Python SDK for WeChat Bot (iLink protocol) — text, image, video messaging & MCP server | 零依赖微信机器人 Python SDK，支持多媒体消息和 MCP 服务器

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Zero-dependency Python SDK for WeChat Bot (iLink protocol) —

Use Cases

Send messages, images, and videos via WeChat Bot integration.
Build AI chatbots for WeChat communication.
Oaklight

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx weilink

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Weilink

Weilink is a zero-dependency Python SDK and MCP server for WeChat Bot automation using the iLink protocol, enabling AI agents to send and receive text, images, voice, files, and video through WeChat. The MCP server integration supports stdio, SSE, and streamable-http transports, making it compatible with Claude, other LLMs, and custom agent frameworks. Developers and teams building AI-powered WeChat assistants use it to automate customer messaging, content distribution, and multi-media notifications without any external Python runtime dependencies.

Prerequisites

  • Python 3.9+ installed
  • pip available in your PATH
  • A WeChat account that can be logged in via QR code (iLink protocol compatible)
  • Optional: weilink[server] for the web admin panel, weilink[mcp] for MCP server support
  • An MCP-compatible client such as Claude Desktop
1

Install the weilink package with MCP support

Install weilink with the mcp extras to enable MCP server functionality. The base package has zero runtime dependencies; MCP support adds the MCP framework.

pip install weilink[mcp]
2

Log in via QR code

Run the login flow to authenticate your WeChat account. Credentials are cached automatically so you will not need to scan again after the first login.

python -c "from weilink import WeiLink; wl = WeiLink(); wl.login()"
3

Start the web admin panel (optional)

Launch the web admin interface to monitor sessions, view logs, and manage the bot without writing code.

pip install weilink[server]
weilink admin -p 8080
4

Start the MCP server

Launch the weilink MCP server in stdio mode for use with Claude Desktop, or in SSE mode for remote agent connections.

# stdio mode (for Claude Desktop):
python -m weilink.mcp

# SSE mode (for remote agents):
python -m weilink.mcp --transport sse --port 8001
5

Add to your MCP client configuration

Register weilink in Claude Desktop configuration to enable WeChat messaging from AI sessions.

Weilink Examples

Client configuration

Claude Desktop configuration to launch the weilink MCP server in stdio mode.

{
  "mcpServers": {
    "weilink": {
      "command": "python",
      "args": ["-m", "weilink.mcp"]
    }
  }
}

Prompts to try

Example prompts for sending messages and receiving WeChat content through an AI assistant using weilink.

- "Send a text message to user 'wxid_abc123' saying 'Your order has shipped'."
- "Check for new WeChat messages received in the last 30 seconds."
- "Send the image at /tmp/invoice.png to the group chat 'Project Team'."
- "Send a video file /tmp/demo.mp4 to contact 'Alice'."
- "Show me the latest 5 messages received on this WeChat account."

Troubleshooting Weilink

QR code login fails or WeChat shows an error

Ensure your WeChat account supports the iLink protocol (personal WeChat accounts work; enterprise WeChat Work accounts use a different protocol). Try `wl.login(force=True)` to force a fresh login if cached credentials are stale.

MCP server fails to start with import error for mcp module

Install with the mcp extras: `pip install weilink[mcp]`. The base `pip install weilink` package does not include MCP dependencies.

Messages are sent but media files are not delivered

Confirm the file path is accessible by the Python process running weilink. For images and videos, use absolute paths. Large files may take longer due to WeChat upload limits; check that the file size is within WeChat's per-message limits.

Frequently Asked Questions about Weilink

What is Weilink?

Weilink is a Model Context Protocol (MCP) server that zero-dependency python sdk for wechat bot (ilink protocol) — text, image, video messaging & mcp server | 零依赖微信机器人 python sdk，支持多媒体消息和 mcp 服务器 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Weilink?

Follow the installation instructions on the Weilink GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Weilink?

Weilink works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Weilink free to use?

Yes, Weilink is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Weilink Alternatives — Similar Communication Servers

Looking for alternatives to Weilink? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.

Slack

★ 86.1k

Enables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl

LibreChat

★ 37.3k

Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA

Note Gen

★ 11.9k

A cross-platform Markdown AI note-taking software.

DeepChat

★ 5.8k

🐬DeepChat - A smart assistant that connects powerful AI to your personal world

WhatsApp MCP

★ 5.7k

Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without

Apple

★ 3.1k

Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

CommunicationBrowse All Servers

Quick Config Preview

{ "mcpServers": { "weilink": { "command": "npx", "args": ["-y", "weilink"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Weilink?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides