MCP 서버 - Twitter NoAuth

로컬 자격 증명이나 토큰 설정 없이 Twitter API 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다. 트윗 검색, 사용자 트윗 가져오기, 트윗 게시, 트윗 답글 작성 등 핵심 Twitter 작업을 제공합니다.

데모 비디오

https://www.youtube.com/watch?v=LOxFqCTPedc

왜 MCP Twitter NoAuth 서버를 사용해야 하나요?

중요한 장점

헤드리스 및 원격 작업 : 이 서버는 브라우저나 로컬 파일 접근 없이 원격 환경에서 완전히 헤드리스로 실행될 수 있습니다.
분리된 아키텍처 : 모든 클라이언트가 OAuth 흐름을 독립적으로 완료한 다음 자격 증명을 컨텍스트로 이 MCP 서버에 전달하여 자격 증명 저장소와 서버 구현이 완전히 분리됩니다.

좋지만 비판적이지는 않음

집중 기능 : 트윗 검색, 사용자 트윗 받기, 트윗 게시, 트윗 답글 등 핵심적인 Twitter 작업을 제공합니다.
Docker 지원 : 컨테이너화를 염두에 두고 설계되어 환경에 구애받지 않고 한 번의 클릭으로 완벽하게 격리된 설정이 가능합니다.
안정적인 종속성 : Twitter API 통합을 위한 표준 Python 요청 라이브러리를 기반으로 구축되었습니다.

특징

Twitter API를 사용하여 트윗 검색
특정 사용자의 최근 트윗 가져오기
특정 사용자의 최근 답변 가져오기
새로운 트윗을 게시하세요
기존 트윗에 답장하기
액세스 토큰을 별도로 새로 고침
자동 새로 고침 토큰 처리

필수 조건

Python 3.10 이상
Twitter API 자격 증명(클라이언트 ID, 클라이언트 비밀, 액세스 토큰 및 새로 고침 토큰)

설치

지엑스피1

도커

Docker 이미지 빌드

# Build the Docker image
docker build -t mcp-twitter-noauth .

Claude Desktop과 함께 사용

Docker 사용법

Claude 구성에 다음을 추가하여 Docker 이미지를 사용하도록 Claude Desktop을 구성할 수 있습니다.

{
  "mcpServers": {
    "twitter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-twitter-noauth:latest"
      ]
    }
  }
}

참고: 이 구성을 사용하면 도구 사용 섹션에 설명된 대로 도구 호출 시 Twitter API 자격 증명을 제공해야 합니다. 자격 증명 저장소와 서버 구현을 분리하기 위해 Twitter 자격 증명은 환경 변수로 전달되지 않습니다.

크로스 플랫폼 퍼블리싱

여러 플랫폼에 Docker 이미지를 게시하려면 docker buildx 명령을 사용할 수 있습니다. 다음 단계를 따르세요.

새로운 빌더 인스턴스를 만듭니다 (아직 만들지 않았다면):
docker buildx create --use
여러 플랫폼에 대한 이미지를 빌드하고 푸시합니다 .
docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-twitter-noauth:latest --push .
지정된 플랫폼에서 이미지를 사용할 수 있는지 확인하세요 .
docker buildx imagetools inspect buryhuang/mcp-twitter-noauth:latest

용법

이 서버는 MCP 도구를 통해 트위터 기능을 제공합니다. 전용 토큰 갱신 도구를 사용하면 인증 처리가 간소화됩니다.

서버 시작

mcp-server-twitter-noauth

도구 사용

Claude와 같은 MCP 클라이언트를 사용하는 경우 인증을 처리하는 두 가지 주요 방법이 있습니다.

토큰 새로 고침(첫 번째 단계 또는 토큰 만료 시)

액세스 토큰과 새로 고침 토큰이 모두 있는 경우:

{
  "twitter_access_token": "your_access_token",
  "twitter_refresh_token": "your_refresh_token",
  "twitter_client_id": "your_client_id",
  "twitter_client_secret": "your_client_secret"
}

액세스 토큰이 만료된 경우 새로 고침 토큰만으로 새로 고칠 수 있습니다.

{
  "twitter_refresh_token": "your_refresh_token",
  "twitter_client_id": "your_client_id",
  "twitter_client_secret": "your_client_secret"
}

이렇게 하면 새로운 액세스 토큰과 만료 시간이 반환되며, 이를 후속 호출에 사용할 수 있습니다.

트윗 검색

Twitter API를 사용하여 트윗을 검색하세요:

{
  "twitter_access_token": "your_access_token",
  "query": "your search query",
  "max_results": 10
}

응답에는 텍스트, 생성 시간, 작성자 정보 등의 트윗 데이터가 포함됩니다.

사용자 트윗 가져오기

특정 사용자의 최근 트윗을 가져옵니다.

{
  "twitter_access_token": "your_access_token",
  "user_id": "twitter_user_id",
  "max_results": 10
}

사용자 답변 받기

특정 사용자의 최근 답변 가져오기:

{
  "twitter_access_token": "your_access_token",
  "user_id": "twitter_user_id",
  "max_results": 10
}

트윗 게시하기

새로운 트윗을 게시하세요:

{
  "twitter_access_token": "your_access_token",
  "text": "This is a test tweet from the MCP Twitter server"
}

트윗에 답장하기

기존 트윗에 답장하기:

{
  "twitter_access_token": "your_access_token",
  "tweet_id": "id_of_tweet_to_reply_to",
  "text": "This is a reply to the original tweet"
}

토큰 새로 고침 워크플로

다음 중 하나를 사용하여 twitter_refresh_token 도구를 호출하여 시작하세요.
- 전체 자격 증명(액세스 토큰, 새로 고침 토큰, 클라이언트 ID 및 클라이언트 비밀번호) 또는
- 액세스 토큰이 만료된 경우 새로 고침 토큰, 클라이언트 ID 및 클라이언트 비밀번호만 있으면 됩니다.
반환된 새 액세스 토큰을 후속 API 호출에 사용합니다.
토큰 만료를 나타내는 응답을 받으면 twitter_refresh_token 도구를 다시 호출하여 새로운 토큰을 받으세요.

이 접근 방식은 모든 작업에 대해 클라이언트 자격 증명을 요구하지 않고도 대부분의 API 호출을 간소화하는 동시에 필요할 때 토큰 새로 고침을 활성화합니다.

Twitter API 자격 증명 얻기

필요한 Twitter API 자격 증명을 얻으려면 다음 단계를 따르세요.

Twitter 개발자 포털 로 이동
새로운 프로젝트와 앱을 만듭니다
OAuth 2.0 인증 설정
앱에 대한 OAuth 설정을 구성하세요
클라이언트 ID와 클라이언트 비밀번호를 생성합니다.
액세스 토큰과 새로 고침 토큰을 얻으려면 OAuth 흐름을 완료하세요.

토큰 새로 고침

이 서버는 토큰 자동 갱신을 구현합니다. 액세스 토큰이 만료되면 서버는 갱신 토큰, 클라이언트 ID, 클라이언트 비밀번호를 사용하여 사용자 개입 없이 새 액세스 토큰을 얻습니다.

보안 참고 사항

이 서버는 Twitter API 자격 증명에 직접 액세스해야 합니다. 토큰과 자격 증명은 항상 안전하게 보관하고 신뢰할 수 없는 사람과 공유하지 마세요.

특허

자세한 내용은 LICENSE 파일을 참조하세요.