AI 조수가 WAHA (WhatsApp HTTP API) 플랫폼을 통해 WhatsApp과 상호 작용 할 수있는 모델 콘텍스 프로토콜 (MCP) 서버.

특징

-Chat Management: 최근 WhatsApp 채팅 개요 -Message Operations: 읽기, 전송 및 표시 메시지

• MCP Resources: 캐싱과 컨텍스트웨어 리소스로 WhatsApp 데이터 접근
• MCP 통합: MCP 클라이언트와 전체 호환성 (스트디오 전송)

설치

1. Clone 이 저장소

2. 의존성 설치:

3. WAHA API 연결 구성:

다음 편집 .env 당신의 WAHA 인스턴스 세부 사항.

구성

.env에 필요한 환경 변수:

• WAHA_BASE_URL: WAHA 서버 URL (예: [T3]])
• WAHA_API_KEY: WAHA API 키 인증
• WAHA_SESSION: WhatsApp 세션 이름 (기본: default)

개발

프로젝트 구축

자동차 로드와 개발 모드에서 실행

MCP 검사를 가진 시험

MCP Inspector는 MCP 서버가 상호 작용적으로 테스트하는 웹 기반 도구입니다.

이것은:

1. WAHA MCP 서버 시작
2. MCP Inspector 웹 UI 출시
3. 브라우저를 자동적으로 여십시오

검사기를 사용하여:

WAHA MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with WhatsApp through the WAHA (WhatsApp HTTP API) platform.

Features

• Chat Management: Get overview of recent WhatsApp chats
• Message Operations: Retrieve, send, and mark messages as read
• MCP Resources: Access WhatsApp data as context-aware resources with caching
• MCP Integration: Full compatibility with MCP clients (stdio transport)

Installation

1. Clone this repository

2. Install dependencies:

   npm install
   

3. Configure your WAHA API connection:

   cp .env.example .env
   

   Then edit .env with your WAHA instance details.

Configuration

Required environment variables in .env:

• WAHA_BASE_URL: Your WAHA server URL (e.g., http://localhost:3000)
• WAHA_API_KEY: Your WAHA API key for authentication
• WAHA_SESSION: WhatsApp session name (default: default)

Development

Build the project

npm run build

Run in development mode with auto-reload

npm run dev

Test with MCP Inspector

The MCP Inspector is a web-based tool to test your MCP server interactively:

npm run inspector

This will:

1. Start the WAHA MCP server
2. Launch the MCP Inspector web UI
3. Open your browser automatically

Use the inspector to:

• Test all tools interactively
• View tool schemas
• See request/response data
• Debug tool calls

Run in production

npm start

Usage with Claude Desktop

Add this to your Claude Desktop MCP configuration:

Windows:

{
  "mcpServers": {
    "waha": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\path\\to\\waha\\dist\\index.js"],
      "env": {
        "WAHA_BASE_URL": "http://localhost:3000",
        "WAHA_API_KEY": "your-api-key-here",
        "WAHA_SESSION": "default"
      }
    }
  }
}

Mac/Linux:

{
  "mcpServers": {
    "waha": {
      "command": "node",
      "args": ["/absolute/path/to/waha-mcp-server/dist/index.js"],
      "env": {
        "WAHA_BASE_URL": "http://localhost:3000",
        "WAHA_API_KEY": "your-api-key-here",
        "WAHA_SESSION": "default"
      }
    }
  }
}

Note: Windows users should use double backslashes (\\) in paths.

Available Tools

Chat Management