Instagram MCP Server

인스타그램 MCP 서버

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

특징

• 관심사를 명확하게 분리한 모듈식 아키텍처
• TypeScript를 사용한 유형 안전 구현
• 향상된 오류 처리 및 로깅
• 환경 변수를 통해 구성 가능
• JSON-RPC 2.0 호환 통신
• 자동 미디어 다운로드 및 메타데이터 생성
• SEO 친화적인 설명 생성

건축학

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

지엑스피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 (선택 사항): 게시물 처리 사이에 대기하는 시간(밀리초)

예:

오류 처리

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

• 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