# 安装 WhatsApp Chat Reader (Unofficial)

- 类型: MCP 工具
- 说明: 读取本地 WhatsApp 聊天记录，便于搜索、分析与自动化提取关键信息。
- 仓库: https://github.com/NabheetCloud/wa-chat-reader

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "WhatsApp Chat Reader (Unofficial)" MCP 服务：
执行：claude mcp add 'io-github-nabheetcloud-wa-chat-reader' -- uvx wa-chat-reader
```

### Codex
```
请帮我安装 askskill 上的 "WhatsApp Chat Reader (Unofficial)" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-nabheetcloud-wa-chat-reader]
command = "uvx"
args = ["wa-chat-reader"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "WhatsApp Chat Reader (Unofficial)" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-nabheetcloud-wa-chat-reader": { "command": "uvx", "args": ["wa-chat-reader"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env WHATSAPP_DB_PATHS=YOUR_VALUE --env WHATSAPP_BACKUP_PATHS=YOUR_VALUE --env WHATSAPP_MAX_DAYS=YOUR_VALUE --env WHATSAPP_DEBUG=YOUR_VALUE --env WHATSAPP_LOG_FILE=YOUR_VALUE --transport stdio io-github-nabheetcloud-wa-chat-reader -- uvx wa-chat-reader
```
需要环境变量：WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE

### Codex
```bash
codex mcp add --env WHATSAPP_DB_PATHS=YOUR_VALUE --env WHATSAPP_BACKUP_PATHS=YOUR_VALUE --env WHATSAPP_MAX_DAYS=YOUR_VALUE --env WHATSAPP_DEBUG=YOUR_VALUE --env WHATSAPP_LOG_FILE=YOUR_VALUE io-github-nabheetcloud-wa-chat-reader -- uvx wa-chat-reader
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-nabheetcloud-wa-chat-reader]
command = "uvx"
args = ["wa-chat-reader"]

[mcp_servers.io-github-nabheetcloud-wa-chat-reader.env]
WHATSAPP_DB_PATHS = "YOUR_VALUE"
WHATSAPP_BACKUP_PATHS = "YOUR_VALUE"
WHATSAPP_MAX_DAYS = "YOUR_VALUE"
WHATSAPP_DEBUG = "YOUR_VALUE"
WHATSAPP_LOG_FILE = "YOUR_VALUE"
```
需要环境变量：WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-nabheetcloud-wa-chat-reader": {
      "command": "uvx",
      "args": [
        "wa-chat-reader"
      ],
      "env": {
        "WHATSAPP_DB_PATHS": "YOUR_VALUE",
        "WHATSAPP_BACKUP_PATHS": "YOUR_VALUE",
        "WHATSAPP_MAX_DAYS": "YOUR_VALUE",
        "WHATSAPP_DEBUG": "YOUR_VALUE",
        "WHATSAPP_LOG_FILE": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-nabheetcloud-wa-chat-reader&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ3YS1jaGF0LXJlYWRlciJdLCJlbnYiOnsiV0hBVFNBUFBfREJfUEFUSFMiOiJZT1VSX1ZBTFVFIiwiV0hBVFNBUFBfQkFDS1VQX1BBVEhTIjoiWU9VUl9WQUxVRSIsIldIQVRTQVBQX01BWF9EQVlTIjoiWU9VUl9WQUxVRSIsIldIQVRTQVBQX0RFQlVHIjoiWU9VUl9WQUxVRSIsIldIQVRTQVBQX0xPR19GSUxFIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE