Welink

v1.0.0Communicationstable

🔍微信聊天数据分析的本地化AI-agent(Docker/Windows/MacOS) · AI分身 / 大模型分析 / 好友排行 / 词云 / 情感趋势 / 群聊画像

chat-analysischat-historychat-mcpllmmacos
Share:
147
Stars
0
Downloads
0
Weekly
0/5

What is Welink?

Welink is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🔍微信聊天数据分析的本地化ai-agent(docker/windows/macos) · ai分身 / 大模型分析 / 好友排行 / 词云 / 情感趋势 / 群聊画像

🔍微信聊天数据分析的本地化AI-agent(Docker/Windows/MacOS) · AI分身 / 大模型分析 / 好友排行 / 词云 / 情感趋势 / 群聊画像

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

Features

  • 🔍微信聊天数据分析的本地化AI-agent(Docker/Windows/MacOS) · AI分身 / 大模型分析 /

Use Cases

Analyze WeChat chat data and history
Generate sentiment trends and word clouds
Profile group conversations and relationships
runzhliu

Maintainer

LicenseAGPL-3.0
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx welink

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 Welink

WeLink is a local AI-powered analysis platform for WeChat (Weixin) chat data. It decrypts and indexes your WeChat message history, then exposes it through an MCP server so that AI assistants like Claude can query conversations, generate relationship timelines, detect sentiment trends, produce word clouds, and simulate group chat dynamics — all processed entirely on your local machine. It runs on macOS, Windows, and via Docker, and supports over 25 LLM providers including OpenAI, DeepSeek, Gemini, and local Ollama models.

Prerequisites

  • macOS 12+, Windows 10 1903+, or Docker installed for the containerized deployment
  • WeChat installed with an existing message database (WeLink only reads your local chat history)
  • The wechat-decrypt tool (https://github.com/ylytdeng/wechat-decrypt) to export a decrypted copy of your WeChat database
  • API key for at least one supported LLM provider (OpenAI, DeepSeek, Claude, Gemini, or a local Ollama endpoint)
  • An MCP-compatible client such as Claude Code CLI to use the MCP server feature
1

Decrypt your WeChat database

Use the wechat-decrypt tool to export your WeChat message history to a decrypted/ directory. WeLink reads this directory at startup and will not have access to live WeChat traffic.

git clone https://github.com/ylytdeng/wechat-decrypt.git
cd wechat-decrypt && python3 decrypt.py
2

Install and launch WeLink

On macOS, download WeLink.dmg from the GitHub releases page and drag it to /Applications. On Windows, extract WeLink-windows-amd64.zip and run WeLink.exe. For Docker, use the provided compose file.

# Docker deployment
git clone https://github.com/runzhliu/welink.git
cd welink && docker compose up
3

Point WeLink to the decrypted data directory

In the WeLink settings UI, set the data source path to the decrypted/ directory produced by wechat-decrypt. WeLink will index your messages (indexing time scales with data size: under 30 seconds for <500K messages).

4

Configure your LLM provider

In WeLink Settings, choose your LLM provider and enter your API key. The default is DeepSeek; you can switch to OpenAI, Claude, Gemini, or any of the 25+ supported providers.

5

Enable the MCP server

In WeLink Settings, enable the built-in MCP server. It exposes WeChat query tools on a local endpoint. Add it to your Claude Code or other MCP client config to use natural-language queries over your chat history.

{
  "mcpServers": {
    "welink": {
      "command": "npx",
      "args": ["welink"],
      "env": {}
    }
  }
}

Welink Examples

Client configuration

Example claude_desktop_config.json entry to connect to a locally running WeLink MCP server. The WeLink app must be running before the MCP client starts.

{
  "mcpServers": {
    "welink": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

Prompts to try

Natural-language prompts for querying your WeChat history through an AI assistant.

- "Who do I chat with the most? Rank my top 10 contacts by message count"
- "Show the sentiment trend in my conversations with Alice over the past 6 months"
- "Generate a word cloud for my group chat '家庭群'"
- "Summarize all messages from Bob this year and identify recurring topics"
- "Which relationships have gone cold? Show contacts I used to message frequently but haven't in 3 months"
- "Search for all messages where someone mentioned 'project deadline' this quarter"

Troubleshooting Welink

WeLink blocked by macOS Gatekeeper on first launch

Right-click the WeLink.app icon and choose Open, then confirm in the dialog. Alternatively, run `xattr -cr /Applications/WeLink.app` in Terminal to remove the quarantine attribute.

Indexing is very slow or runs out of memory

For large databases (2M+ messages), WeLink requires 8GB+ of RAM. Close other applications during indexing. Consider running the Docker deployment on a machine with adequate resources, or split large databases.

LLM responses are slow or time out

Check your API key and provider connectivity in WeLink Settings → Diagnostics. For faster local processing, switch to Ollama with a small model (e.g., llama3.1:8b). Ensure the Ollama server is running at its default port.

Frequently Asked Questions about Welink

What is Welink?

Welink is a Model Context Protocol (MCP) server that 🔍微信聊天数据分析的本地化ai-agent(docker/windows/macos) · ai分身 / 大模型分析 / 好友排行 / 词云 / 情感趋势 / 群聊画像 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Welink?

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

Which AI clients work with Welink?

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

Is Welink free to use?

Yes, Welink is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

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

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

Read the full setup guide →

Ready to use Welink?

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