MCP-Twikit 프로젝트 상세 소개

프로젝트 개요

MCP-Twikit은 Twitter와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 프로젝트는 MCP 프로토콜을 통해 AI 도우미(예: Claude Desktop)에 강력한 Twitter 데이터 액세스 및 분석 기능을 제공합니다.

핵심 기능

1. Twitter 검색 기능

키워드로 트윗 검색 지원
검색 결과 수 지정 가능
시간순 정렬 지원 (최신 우선)
특정 사용자 트윗 검색 가능 (to:username 구문 사용)

2. 타임라인 가져오기

사용자 개인 Twitter 타임라인 가져오기
최신 트윗 내용 실시간 액세스
다양한 트윗 유형 분석 지원

3. 소셜 미디어 감정 분석

트윗 감정 경향 일괄 분석
여러 계정의 대중 감정 비교
상세한 감정 분석 보고서 생성

설치 및 구성

자동 설치 (권장)

Smithery를 통해 Claude Desktop에 자동 설치:

npx -y @smithery/cli install mcp-twikit --client claude

수동 구성

Claude Desktop 구성 파일에 추가:

{
  "mcpServer": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/adhikasp/mcp-twikit", "mcp-twikit"],
    "env": {
      "TWITTER_USERNAME": "@example",
      "TWITTER_EMAIL": "[email protected]",
      "TWITTER_PASSWORD": "secret"
    }
  }
}

MCP 클라이언트 CLI 사용

mcp-client-cli 도구를 통한 상호 작용 사용 지원.

실제 적용 시나리오

1. 브랜드 감정 모니터링

프로젝트 문서는 실제 사례를 보여줍니다: 인도네시아 4대 인터넷 서비스 제공업체의 고객 감정 분석:

$ llm compare 20 latest tweet directed @IndiHomeCare, @di_cbn, @BiznetHome, @ID_MyRepublic. What are people sentiment to the product? Do 1 search for each account

분석 결과:

IndiHomeCare: 주로 부정적인 감정 (네트워크 불안정, 응답 느림)
CBN: 대부분 부정적인 감정 (장기적인 네트워크 단절, 고객 서비스 응답 느림)
BiznetHome: 강한 부정적인 감정 (네트워크 중단 빈번, 속도 느림)
MyRepublic: 극도로 부정적인 감정 (심각한 서비스 중단, 고객 서비스 매우 나쁨)

2. 개인 타임라인 분석

$ llm what is happening on my twitter timeline?

분석 및 요약 가능:

전문/기술 뉴스
중요 트윗 요약
다양한 주제 분류 정리

기술 특징

모델 컨텍스트 프로토콜 통합

MCP 표준 기반으로 구축
Claude Desktop과 원활하게 통합
도구 호출 및 구조화된 응답 지원

다기능 API 지원

search_twitter: 트윗 검색 기능
get_timeline: 타임라인 가져오기 기능
복잡한 쿼리 구문 및 매개변수 구성 지원

보안 인증

사용자 이름/이메일/비밀번호 인증 지원
환경 변수 보안 구성
Twitter API 사용 규정 준수

사용 권장 사항

기업 응용: 브랜드 모니터링, 경쟁사 분석, 고객 감정 추적에 적합
개인 사용: 타임라인 관리, 추세 분석, 소셜 미디어 통찰력
연구 용도: 소셜 미디어 연구, 감정 분석 연구, 데이터 마이닝

주의 사항

유효한 Twitter 계정 자격 증명 필요
Twitter 사용 약관 및 API 제한 준수
계정 위험을 피하기 위해 요청 빈도 합리적으로 제어 권장
데이터 사용이 개인 정보 보호 요구 사항을 준수하는지 확인

mcp-twikit