Home
Login
apify/actors-mcp-server

Apify Actors의 모델 컨텍스트 프로토콜(MCP) 서버 구현으로, AI 애플리케이션이 Apify Actor를 도구로 사용하여 데이터 추출, 웹 검색 등의 작업을 수행할 수 있도록 합니다.

Apache-2.0TypeScript 231apify Last Updated: 2025-06-13
https://github.com/apify/actors-mcp-server

Apify Actors MCP 서버 상세 소개

프로젝트 개요

Apify Actors MCP 서버는 모델 컨텍스트 프로토콜(Model Context Protocol, MCP) 기반의 서버 구현체로, Apify 플랫폼의 모든 Actor에 대해 통일된 인터페이스 접근을 제공합니다. 이 프로젝트는 AI 애플리케이션과 AI 에이전트가 표준화된 프로토콜을 통해 Apify의 데이터 추출 도구와 상호 작용할 수 있도록 합니다.

프로젝트 주소: https://github.com/apify/actors-mcp-server
주요 용도: Apify Store의 200개 이상의 데이터 추출 도구를 다양한 AI 애플리케이션에 AI 도구로 통합
지원 플랫폼: Claude Desktop, Visual Studio Code, LibreChat 등 다양한 MCP 클라이언트

핵심 기능 특성

🔧 이중 배포 모드

  • MCP 서버 Actor: HTTP 서버로 Apify 플랫폼에서 실행되며, 서버 전송 이벤트(SSE)를 통해 접근 제공
  • 로컬 Stdio 서버: 로컬 머신에서 실행되며, 표준 입력/출력(stdio)을 통해 클라이언트와 통신

🛠️ 풍부한 도구 통합

프로젝트는 기본적으로 다음과 같은 핵심 Actor 도구를 사전 구성합니다.

  • Instagram 크롤러 (apify/instagram-scraper): Instagram 게시물, 프로필, 위치, 사진 및 댓글 추출
  • RAG 웹 브라우저 (apify/rag-web-browser): 웹 검색, 페이지 내용 크롤링 및 구조화된 데이터 반환
  • Google Maps 연락처 추출기 (lukaskrivka/google-maps-with-contact-details): Google Maps의 비즈니스 연락처 정보 추출

🔍 스마트 도구 검색

  • get-actor-details: 특정 Actor의 문서, 입력 스키마 및 상세 정보 검색
  • discover-actors: 키워드를 사용하여 관련 Actor 검색 및 상세 정보 반환
  • 동적 도구 관리: 런타임 시 Actor 도구 추가 및 제거 지원 (클라이언트 지원 필요)

🎯 다중 클라이언트 지원

다음 MCP 클라이언트를 지원합니다.

  • Claude Desktop: Stdio 전송 프로토콜 사용
  • Visual Studio Code: Stdio 및 SSE 전송 지원
  • LibreChat: Stdio 및 SSE 전송 지원
  • Apify 테스트 클라이언트: 완전한 SSE 지원 및 인증 헤더
  • 기타 표준 MCP 클라이언트

기술 아키텍처

프로토콜 지원

  • MCP (Model Context Protocol): AI 애플리케이션과 외부 도구 간의 안전하고 제어 가능한 상호 작용을 구현하는 개방형 프로토콜
  • 전송 방식:
    • Server-Sent Events (SSE) - 원격 HTTP 서버용
    • Standard Input/Output (Stdio) - 로컬 프로세스 통신용

입력 처리 최적화

  • 설명 절단: 500자 이내로 제한하여 호환성 향상
  • 열거형 필드 최적화: 길이 제한 200자 이내로 병합
  • 필수 필드 표시: 필수 파라미터 명확하게 식별
  • 중첩 속성 구축: 프록시 구성 등 복잡한 구조 처리
  • 타입 추론: 배열 항목 타입 자동 추론

사용 시나리오 예시

데이터 연구 분석

"웹을 검색하고 AI 에이전트의 최신 트렌드를 요약해줘"
"The Rock의 Instagram 프로필을 찾아서 분석해줘"

비즈니스 정보 수집

"샌프란시스코에서 상위 10개의 최고의 이탈리아 레스토랑을 찾아줘"
"특정 지역의 Google Maps 비즈니스 연락처 정보를 추출해줘"

콘텐츠 제작 지원

"모델 컨텍스트 프로토콜을 사용하는 단계별 가이드와 소스 URL을 제공해줘"
"Facebook 페이지의 최신 게시물 트렌드를 분석해줘"

설치 구성

Claude Desktop 구성

{
  "mcpServers": {
    "actors-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Visual Studio Code 구성

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apify_token",
        "description": "Apify API Token",
        "password": true
      }
    ],
    "servers": {
      "actors-mcp-server": {
        "command": "npx",
        "args": ["-y", "@apify/actors-mcp-server"],
        "env": {
          "APIFY_TOKEN": "${input:apify_token}"
        }
      }
    }
  }
}

사용자 정의 Actor 구성

{
  "command": "npx",
  "args": [
    "-y", "@apify/actors-mcp-server",
    "--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
  ],
  "env": {
    "APIFY_TOKEN": "your-apify-token"
  }
}

시스템 요구 사항

기본 환경

  • Node.js: v18 이상
  • 운영체제: macOS, Windows 또는 Linux
  • Apify API Token: Apify 플랫폼 서비스 접근용

클라이언트 요구 사항

  • Claude Desktop 최신 버전
  • Visual Studio Code (MCP 확장 지원)
  • 또는 기타 호환 가능한 MCP 클라이언트

성능 제한

리소스 구성

  • 메모리 제한: 각 Actor당 4GB 메모리 제한
  • 무료 사용자: 총 8GB 제한, MCP 서버용 128MB 예약 필요
  • 동시 처리: 여러 Actor 동시 실행 지원

아키텍처 최적화

  • 스키마 처리: JSON Schema 표준 호환
  • 설명 최적화: 자동 절단 및 포맷
  • 오류 처리: 완벽한 예외 처리 메커니즘

개발 디버깅

MCP 검사기 도구

export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-server

예제 클라이언트

프로젝트는 완전한 예제 코드를 제공합니다.

  • Stdio 클라이언트: examples/clientStdio.ts
  • SSE 클라이언트: examples/clientSse.ts

프로젝트 요약

Apify Actors MCP 서버는 AI 애플리케이션 도구 통합의 중요한 진전을 나타내며, 표준화된 MCP 프로토콜을 통해 강력한 데이터 추출 능력을 다양한 AI 애플리케이션에 제공합니다. 이 프로젝트의 주요 가치는 다음과 같습니다.

핵심 강점

  1. 통일된 인터페이스: 단일 프로토콜을 통해 200개 이상의 전문 데이터 추출 도구에 접근
  2. 유연한 배포: 클라우드 및 로컬의 두 가지 배포 모드 지원
  3. 광범위한 호환성: 주요 AI 개발 도구 및 플랫폼과 통합
  4. 쉬운 확장: 동적 Actor 도구 추가 및 사용자 정의 지원

애플리케이션 가치

  • AI 능력 향상: AI 애플리케이션에 실시간 데이터 획득 능력 제공
  • 통합 단순화: 표준화된 인터페이스로 개발 복잡성 감소
  • 가능성 확장: 개방형 아키텍처로 무한한 확장 지원
  • 기업 준비 완료: 성숙한 플랫폼과 완벽한 문서 지원

적용 가능한 시나리오

  • AI 에이전트 개발
  • 데이터 분석 및 연구
  • 콘텐츠 제작 및 관리
  • 비즈니스 인텔리전스 및 시장 조사
  • 자동화된 데이터 수집

이 프로젝트는 AI 애플리케이션의 데이터 획득 요구 사항에 대한 강력하고 유연하며 사용하기 쉬운 솔루션을 제공하며, 현대 AI 도구 스택의 중요한 구성 요소입니다.