인스타그램 MCP 서버

Chrome의 기존 로그인 세션을 사용하여 Instagram 게시물을 가져오기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

• 관심사를 명확하게 분리한 모듈식 아키텍처

• TypeScript를 사용한 유형 안전 구현

• 향상된 오류 처리 및 로깅

• 환경 변수를 통해 구성 가능

• JSON-RPC 2.0 호환 통신

• 자동 미디어 다운로드 및 메타데이터 생성

• SEO 친화적인 설명 생성

Related MCP server: Insta MCP Server

건축학

서버는 다음과 같은 구조를 가진 모듈형 아키텍처를 따릅니다.

지엑스피1

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• CHROME_USER_DATA_DIR : 로그인 세션이 포함된 Chrome 사용자 데이터 디렉토리 경로

추가 구성 옵션은 구성 관리자를 통해 사용할 수 있습니다.

• 브라우저 설정(뷰포트, 시간 초과)

• Instagram 설정(지연, 배치 크기)

• 디렉토리 및 파일 경로 저장

용법

1. 종속성 설치:

   npm install

2. 서버를 빌드하세요:

   npm run build

3. 서버를 실행합니다:

   CHROME_USER_DATA_DIR=/path/to/chrome/profile npm start

사용 가능한 도구

인스타그램 게시물 받기

Instagram 프로필에서 최근 게시물을 가져옵니다.

매개변수:

• username (필수): 게시물을 가져올 Instagram 사용자 이름

• limit (선택 사항): 가져올 게시물 수(1-50) 또는 "모두"

• saveDir (선택 사항): 미디어 파일 및 메타데이터를 저장할 디렉토리

• delayBetweenPosts (선택 사항): 게시물 처리 사이에 대기하는 시간(밀리초)

예:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "call_tool",
  "params": {
    "name": "get_instagram_posts",
    "arguments": {
      "username": "example",
      "limit": 10
    }
  }
}

오류 처리

서버는 표준화된 오류 코드와 메시지를 사용합니다.

• INVALID_REQUEST : 잘못된 요청 형식 또는 매개변수입니다.

• INVALID_PARAMS : 매개변수가 누락되었거나 잘못되었습니다.

• METHOD_NOT_FOUND : 알 수 없는 메서드 또는 도구

• INTERNAL_ERROR : 서버 측 오류

개발

1. 개발 모드에서 시작:

   npm run dev

2. linter 실행:

   npm run lint

원본에 비해 개선된 점

1. 모듈형 아키텍처

   • 관심사의 명확한 분리

   • 더 나은 코드 구성

   • 유지 관리 및 확장이 더 쉽습니다.

2. 유형 안전

   • 포괄적인 TypeScript 유형

   • 더 나은 오류 포착

   • 개선된 IDE 지원

3. 오류 처리

   • 표준화된 오류 코드

   • 더 나은 오류 메시지

   • 적절한 오류 전파

4. 구성

   • 중앙 집중식 구성

   • 환경 변수 검증

   • 유형 안전 구성 액세스

5. 코드 품질

   • 일관된 코딩 스타일

   • 더 나은 문서화

   • 개선된 로깅

6. 테스트 지원

   • 모듈식 설계로 테스트 가능

   • 종속성 주입 준비 완료

   • 명확한 인터페이스

특허

MIT