Whatsapp

🚀 WhatsApp MCP 協議服務器

本項目是一個用於與 WhatsApp 交互的 MCP（模型上下文協議）服務器，系統包含 Go 語言橋樑和 Python MCP 服務器兩大組件。前者負責對接 WhatsApp API 並存儲消息歷史，後者實現 MCP 協議，為 Claude 提供標準化工具。

🚀 快速開始

下載代碼

使用 Git 克隆項目倉庫：

git clone https://github.com/your-username/whatsapp-mcp.git

進入 WhatsApp-MCP 目錄：

cd whatsapp-mcp

運行 Go 橋樑

啟動橋樑之前，確保安裝了 Go 語言環境。然後在終端運行以下命令：

go run bridge/main.go

啟動 Python MCP 服務器

該服務器使用 Flask 框架實現。首先安裝依賴項：

pip install flask requests

然後運行服務器：

python server/mcp_server.py

✨ 主要特性

數據存儲

• 數據庫位置：whatsapp-bridge/store/
• 聊天記錄：所有消息按時間順序存儲，並支持快速搜索和檢索。
• 索引優化：通過 SQLite 的查詢優化技術，提升數據訪問效率。

MCP 工具

Claude 可以通過以下工具與 WhatsApp 交互：

搜索功能

• search_contacts：根據姓名或號碼查找聯繫人。
• list_messages：檢索消息，支持過濾和上下文擴展。
• list_chats：列出所有可用聊天記錄，含元數據。

聯繫人操作

• get_chat：獲取特定聊天的詳細信息。
• get_direct_chat_by_contact：查找與指定聯繫人的直接對話。
• get_contact_chats：列舉特定聯繫人參與的所有聊天。

消息處理

• get_last_interaction：獲取與某個聯繫人的最新消息。
• get_message_context：獲取某條消息的上下文信息。

發送功能

• send_message：向指定號碼或群組發送文本消息。
• send_file：發送圖片、視頻、文檔等文件。
• send_audio_message：發送音頻消息，需確保為 .ogg 格式或安裝 FFmpeg 進行格式轉換。

媒體管理

• download_media：下載指定消息中的媒體文件，並返回本地路徑。

媒體處理

發送規則

• 支持類型：圖片、視頻、文檔等可通過 send_file 發送。
• 音頻發送：使用 send_audio_message 工具，需 .ogg 格式或 FFmpeg 轉換。

下載功能

默認僅存儲媒體的元數據。要獲取實際文件，請使用 download_media 工具，輸入 message_id 和 chat_jid 即可下載並返回路徑。

🔧 技術細節

1. 請求流程：Claude -> Python 服務器 -> Go 橋樑 -> WhatsApp API
2. 數據存儲：所有消息存入 SQLite 數據庫，確保高效查詢。
3. 設備限制：WhatsApp 設備鏈接數有限制，請定期清理不再使用的設備。

📚 詳細文檔

故障排除

• 權限問題：確保腳擁有足夠的文件訪問權限。若 PATH 環境變量未配置，建議使用全路徑執行命令。
• 認證失敗：檢查是否已達到 WhatsApp 的設備限制，可通過手機設置 -> 鏈接設備管理清理舊設備。

示例代碼

Go 橋樑啟動

package main

import (
    "fmt"
    "log"
)

func main() {
    fmt.Println("WhatsApp Bridge Started")
    // 數據庫初始化邏輯
}

Python 服務器運行

from flask import Flask
import requests

app = Flask(__name__)

@app.route('/api/send_message', methods=['POST'])
def send_message():
    # 處理消息發送邏輯
    return "Message Sent"

命令行示例

啟動橋樑：

go run bridge/main.go

運行服務器：

python server/mcp_server.py

📄 許可證

本項目遵循 MIT 許可證，具體內容請參閱 LICENSE 文件。