모델 컨텍스트 프로토콜(MCP)�� 사용하여 WhatsApp 웹과 AI 모델을 연결하는 강력한 브리지입니다. 이 프로젝트는 Claude와 같은 AI 모델이 표준화된 인터페이스를 통해 WhatsApp과 상호 작용할 수 있도록 지원하여 WhatsApp 상호 작용을 프로그래밍 방식으로 쉽게 자동화하고 향상시킬 수 있도록 합니다.
WhatsApp Web MCP는 다음을 통해 WhatsApp Web과 AI 모델 간의 원활한 통합을 제공합니다.
중요 : 이 도구는 테스트 목적으로만 사용되며 실제 운영 환경에서는 사용하면 안 됩니다.
WhatsApp 웹 프로젝트의 면책 조항:
이 프로젝트는 WhatsApp 또는 그 자회사나 계열사와 제휴, 제휴, 승인, 보증 또는 어떤 방식으로든 공식적으로 연결되어 있지 않습니다. 공식 WhatsApp 웹사이트는 whatsapp.com에서 확인하실 수 있습니다. "WhatsApp" 및 관련 이름, 상표, 엠블럼, 이미지는 해당 소유자의 등록 상표입니다. 또한, 이 방법을 사용하더라도 차단되지 않을 것이라는 보장은 없습니다. WhatsApp은 플랫폼에서 봇이나 비공식 클라이언트를 허용하지 않으므로 완전히 안전하다고 할 수는 없습니다.
| 옵션 | 별명 | 설명 | 선택 | 기본 |
|---|---|---|---|---|
--mode | -m | 실행 모드 | mcp , whatsapp-api | mcp |
--mcp-mode | -c | MCP 연결 모드 | standalone , api | standalone |
--transport | -t | MCP 전송 모드 | sse , command | sse |
--sse-port | -p | SSE 서버용 포트 | - | 3002 |
--api-port | - | WhatsApp API 서버용 포트 | - | 3001 |
--auth-data-path | -a | 인증 데이터를 저장하는 경로 | - | .wwebjs_auth |
--auth-strategy | -s | 인증 전략 | local , none | local |
--api-base-url | -b | API 모드를 사용할 때 MCP에 대한 API 기반 URL | - | http://localhost:3001/api |
--api-key | -k | API 모드를 사용할 때 WhatsApp Web REST API에 대한 API 키 | - | '' |
API 모드에서 실행할 경우 WhatsApp API 서버는 API 키를 사용한 인증을 요구합니다. API 키는 WhatsApp API 서버를 시작할 때 자동으로 생성되며 로그에 표시됩니다.
MCP 서버를 WhatsApp API 서버에 연결하려면 --api-key 또는 -k 옵션을 사용하여 이 API 키를 제공해야 합니다.
API 키는 인증 데이터 디렉토리( --auth-data-path 로 지정)에 저장되며 WhatsApp API 서버를 다시 시작할 때까지 유지됩니다.
REST 엔드포인트를 통해 WhatsApp 기능을 노출하는 독립형 WhatsApp API 서버를 실행합니다.
WhatsApp Web에 직접 연결되는 MCP 서버를 실행합니다.
WhatsApp API 서버에 연결하는 MCP 서버를 실행합니다.
| 도구 | 설명 | 매개변수 |
|---|---|---|
get_status | WhatsApp 클라이언트 연결 상태 확인 | 없음 |
send_message | WhatsApp 연락처로 메시지 보내기 | number : message 를 보낼 전화번호 : 보낼 텍스트 내용 |
search_contacts | 이름이나 번호로 연락처 검색 | query : 연락처를 찾기 위한 검색어 |
get_messages | 특정 채팅에서 메시지 검색 | number : 메시지를 받을 전화번호 limit (선택사항): 검색할 메시지 수 |
get_chats | 모든 WhatsApp 채팅 목록 받기 | 없음 |
create_group | 새로운 WhatsApp 그룹을 만드세요 | name : 그룹 participants 이름 : 추가할 전화번호 배열 |
add_participants_to_group | 기존 그룹에 참가자 추가 | groupId : 그룹 participants 의 ID : 추가할 전화번호 배열 |
get_group_messages | 그룹에서 메시지 검색 | groupId : 그룹 limit 의 ID(선택 사항): 검색할 메시지 수 |
send_group_message | 그룹에 메시지 보내기 | groupId : 그룹 message 의 ID : 보낼 텍스트 콘텐츠 |
search_groups | 이름, 설명 또는 회원 이름으로 그룹 검색 | query : 그룹을 찾기 위한 검색어 |
get_group_by_id | 특정 그룹에 대한 자세한 정보를 얻으세요 | groupId : 가져올 그룹의 ID |
| 리소스 URI | 설명 |
|---|---|
whatsapp://contacts | 모든 WhatsApp 연락처 목록 |
whatsapp://messages/{number} | 특정 채팅의 메시지 |
whatsapp://chats | 모든 WhatsApp 채팅 목록 |
whatsapp://groups | 모든 WhatsApp 그룹 목록 |
whatsapp://groups/search | 이름, 설명 또는 회원 이름으로 그룹 검색 |
whatsapp://groups/{groupId}/messages | 특정 그룹의 메시지 |
| 엔드포인트 | 방법 | 설명 | 매개변수 |
|---|---|---|---|
/api/status | 얻다 | WhatsApp 연결 상태 가져오기 | 없음 |
/api/contacts | 얻다 | 모든 연락처 가져오기 | 없음 |
/api/contacts/search | 얻다 | 연락처 검색 | query : 검색어 |
/api/chats | 얻다 | 모든 채팅 받기 | 없음 |
/api/messages/{number} | 얻다 | 채팅에서 메시지 받기 | limit (쿼리): 메시지 수 |
/api/send | 우편 | 메시지 보내기 | number : 수신자 message : 메시지 내용 |
| 엔드포인트 | 방법 | 설명 | 매개변수 |
|---|---|---|---|
/api/groups | 얻다 | 모든 그룹 가져오기 | 없음 |
/api/groups/search | 얻다 | 그룹 검색 | query : 검색어 |
/api/groups/create | 우편 | 새 그룹을 만듭니다 | name : 그룹 이름 participants : 숫자 배열 |
/api/groups/{groupId} | 얻다 | 특정 그룹에 대한 자세한 정보를 얻으세요 | 없음 |
/api/groups/{groupId}/messages | 얻다 | 그룹으로부터 메시지 받기 | limit (쿼리): 메시지 수 |
/api/groups/{groupId}/participants/add | 우편 | 그룹에 멤버 추가 | participants : 숫자 배열 |
/api/groups/send | 우편 | 그룹에 메시지 보내기 | groupId : 그룹 ID message : 메시지 내용 |
이 프로젝트는 관심사를 명확하게 분리하여 구성됩니다.
이 아키텍처는 다음을 포함한 유연한 배포 시나리오를 허용합니다.
이 프로젝트에서는 단위 테스트를 위해 Jest를 사용합니다. 테스트를 실행하려면 다음을 수행하세요.
이 프로젝트에서는 코드 품질과 형식을 위해 ESLint와 Prettier를 사용합니다.
린팅 구성은 TypeScript 모범 사례를 적용하고 프로젝트 전체에서 일관된 코드 스타일을 유지합니다.
귀하의 PR을 확인하십시오:
이 프로젝트는 WhatsApp 웹 브라우저 앱을 통해 연결되는 WhatsApp 웹용 비공식 JavaScript 클라이언트 라이브러리인 whatsapp-web.js를 사용합니다. 자세한 내용은 whatsapp-web.js GitHub 저장소를 참조하세요.
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
WhatsApp Web MCP에는 Winston으로 구축된 강력한 로깅 시스템이 포함되어 있습니다. 로깅 시스템은 다음과 같은 기능을 제공합니다.
이 애플리케이션은 자세한 정도에 따라 다음과 같은 로그 수준을 지원합니다.
--log-level 또는 -l 플래그를 사용하여 애플리케이션을 시작할 때 로그 수준을 구성할 수 있습니다.
또는 글로벌 설치를 사용하는 경우:
MCP 명령 모드( --mode mcp --transport command )에서 실행할 경우 모든 로그는 stderr로 전송됩니다. 이는 stdout을 데이터 출력에 사용하고 stderr을 로깅 및 진단에 사용하는 명령줄 도구에 중요합니다. 이를 통해 stdout을 통한 MCP 프로토콜 통신이 로그 메시지에 의해 방해받지 않도록 할 수 있습니다.
테스트 환경( NODE_ENV=test 또는 Jest로 실행하는 경우)에서 로거는 테스트 환경에 적합하도록 자동으로 동작을 조정합니다.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
모델 컨텍스트 프로토콜을 사용하여 WhatsApp Web을 AI 모델에 연결하는 브리지로, Claude와 다른 AI 시스템이 표준화된 인터페이스를 통해 WhatsApp과 상호 작용할 수 있도록 합니다.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/fyimail/whatsapp-mcp2'
If you have feedback or need assistance with the MCP directory API, please join our Discord server