트위터 MCP 서버

AI 에이전트를 위한 강력한 Twitter 통합 솔루션으로, MCP(Model Context Protocol) 표준을 활용하여 깔끔하고 일관된 인터페이스를 통해 포괄적인 Twitter 기능 세트를 제공합니다.

개요

이 서버는 MCP 도구를 통해 Twitter 기능에 대한 액세스를 제공하여 AI 어시스턴트 및 기타 MCP 호환 클라이언트와의 원활한 통합을 지원합니다. agent-twitter-client 라이브러리를 기반으로 구축되었으며, 강력한 오류 처리, 속도 제한 및 일관된 응답 형식을 제공합니다.

Related MCP server: MCP Twitter

특징

기본 독해

• 미디어 지원을 통해 사용자의 트윗을 받으세요

• 자세한 정보가 포함된 사용자 프로필 가져오기

• 해시태그 또는 키워드로 트윗 검색

• 최신/인기순으로 검색 결과 필터링

• 속도 제한(요청당 최대 50개 트윗)

사용자 상호 작용

• 트윗 좋아요/싫어요

• 리트윗/리트윗 취소

• 다음과 같은 내용으로 트윗을 게시하세요:

  • 텍스트 콘텐츠

  • 미디어 첨부 파일(이미지, 비디오)

  • 답장 기능

  • 인용 트윗 기능

고급 기능

• 사용자 관계(팔로워/팔로잉) 가져오기

• 인기 주제 가져오기

• 다양한 타임라인 유형에 액세스:

  • 홈 타임라인

  • 타임라인을 따라가다

  • 사용자 타임라인

• 목록 관리(목록 트윗 가져오기)

미디어 및 고급 상호 작용

• 미디어 처리:

  • 이미지 업로드(JPEG, PNG, GIF)

  • 비디오 업로드(MP4)

  • 대체 텍스트 지원

• 스레드 생성

• 사용자 팔로우/팔로우 취소

도구

독서 도구

• get_tweets - 사용자의 최근 트윗 가져오기

• get_profile - 사용자 프로필 정보 가져오기

• search_tweets - 해시태그 또는 키워드로 트윗 검색

상호작용 도구

• like_tweet - 트윗에 좋아요 또는 싫어요 표시

• retweet - 리트윗 또는 리트윗 취소

• post_tweet - 선택적인 미디어를 포함한 새로운 트윗 게시

• create_thread - 트위터 스레드 만들기

타임라인 도구

• get_timeline - 다양한 타임라인 유형에서 트윗 가져오기

• get_list_tweets - Twitter 목록에서 트윗 가져오기

• get_trends - 현재 인기 있는 주제 가져오기

사용자 관리 도구

• get_user_relationships - 팔로워 또는 팔로잉 목록 가져오기

• follow_user - 사용자를 팔로우하거나 팔로우 취소합니다.

설치

1. 종속성 설치:

지엑스피1

2. 서버를 빌드하세요:

npm run build

3. 환경 변수 구성:

# Required: Twitter Account Credentials (for user authentication)
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter API Authentication (Optional)
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

4. MCP 클라이언트에 서버 구성을 추가합니다.

MacOS의 경우:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows의 경우:

%APPDATA%/Claude/claude_desktop_config.json

구성:

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "/path/to/twitter-mcp-server/build/index.js"
    }
  }
}

개발

자동 재빌드를 사용한 개발의 경우:

npm run watch

디버깅

MCP 서버는 stdio를 통해 통신하므로 MCP Inspector를 사용하여 디버깅할 수 있습니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

• 모든 매개변수에 대한 입력 검증

• 속도 제한 보호

• 자세한 오류 메시지

• 적절한 오류 전파

• 디버깅을 위한 로깅

응답 형식

모든 도구는 일관된 형식으로 응답을 반환합니다.

{
  content: [{
    type: "text",
    text: string // JSON stringified response or error message
  }]
}

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.