MCP 에볼루션 API

WhatsApp 자동화를 위한 Evolution API 와 통합되는 Claude용 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버를 통해 Claude는 Evolution API를 통해 WhatsApp과 상호 작용하여 다음과 같은 기능을 사용할 수 있습니다.

WhatsApp 인스턴스 관리
다양한 유형의 메시지 보내기
연락처 및 그룹 작업
웹후크 및 설정 구성

Related MCP server: API Tester MCP Server

📂 프로젝트 구조

지엑스피1

🚀 빠른 설정

환경 설정

Evolution API 자격 증명으로 .env 파일을 만듭니다.

EVOLUTION_API_URL=https://your-evolution-api-server.com EVOLUTION_API_KEY=your-api-key-here

📋 배포 옵션

환경	단계	명령
지역 개발	1. 복제 및 설치 2. 개발자 모드에서 실행	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install` `bun run dev`
현지 생산	1. 복제 및 설치 2. 빌드 및 실행	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api && bun install` `bun run build && bun run dist/main.js`
도커 컴포즈	Docker Compose로 실행	`git clone https://github.com/aiteks-ltda/mcp-evo-api.git && cd mcp-evo-api` `docker-compose up -d`
도커	컨테이너 빌드 및 실행	`docker run -d -p 3000:3000 -e EVOLUTION_API_URL=yoururl -e EVOLUTION_API_KEY=yourkey --name mcp-evo-api ghcr.io/aiteks-ltda/mcp-evo-api:latest`

클로드 데스크톱 구성

Claude Desktop 구성 파일(일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 위치)에 다음을 추가합니다.

{ "mcpServers": { "evo-api": { "command": "node", "args": [ "/path/to/your/mcp-evo-api/dist/main.js" ] } } }

Docker 배포를 사용하는 경우:

{ "mcpServers": { "evo-api": { "url": "http://localhost:3000" } } }

📊 구현 상태

범주	구현됨	보류 중인 구현
핵심 API	✅ 정보 가져오기✅ 인스턴스 생성✅ 인스턴스 가져오기✅ 인스턴스 연결✅ 인스턴스 다시 시작✅ 연결 상태 인스턴스 로그아웃✅ 인스턴스 삭제✅ 상태 설정	❌ 체크는 왓츠앱입니다
웹훅 및 설정	✅ 웹훅 설정✅ 웹훅 찾기✅ 설정 설정✅ 설정 찾기
메시징	✅ 일반 텍스트 보내기 ✅ 상태 보내기 ✅ 미디어 보내기 ✅ WhatsApp 오디오 보내기 ✅ 스티커 보내기 ✅ 위치 보내기 ✅ 연락처 보내기 ✅ 반응 보내기 ✅ 여론조사 보내기 ✅ 목록 보내기 ✅ 버튼 보내기	❌ 메시지를 읽음으로 표시❌ 메시지를 읽지 않음으로 표시❌ 채팅 보관❌ 모든 사람에게서 메시지 삭제❌ 메시지 업데이트❌ 상태 메시지 보내기(채팅 Ctrl)
채팅 및 연락처	✅ 연락처 찾기✅ 채팅 찾기	❌ 차단 상태 업데이트❌ 프로필 사진 URL 가져오기❌ Base64 가져오기❌ 메시지 찾기❌ 상태 메시지 찾기
여러 떼	✅ JID로 그룹 찾기✅ 모든 그룹 가져오기✅ 그룹 구성원 찾기	❌ 그룹 만들기❌ 그룹 사진 업데이트❌ 그룹 제목 업데이트❌ 그룹 설명 업데이트❌ 초대 코드 가져오기❌ 초대 코드 취소❌ 그룹 초대 보내기❌ 초대 코드로 그룹 찾기❌ 그룹 구성원 업데이트❌ 그룹 설정 업데이트❌ 임시 그룹 전환❌ 그룹 나가기
프로필 설정		❌ 비즈니스 프로필 가져오기❌ 프로필 가져오기❌ 프로필 이름 업데이트❌ 프로필 상태 업데이트❌ 프로필 사진 업데이트❌ 프로필 사진 제거❌ 개인정보 보호 설정 가져오기❌ 개인정보 보호 설정 업데이트
봇 통합		❌ Typebot 통합❌ OpenAI 통합❌ Evolution Bot❌ Dify Bot❌ Flowise Bot
기타 통합		❌ Chatwoot❌ 웹소켓❌ SQS❌ RabbitMQ