X MCP 서버

X(트위터) 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버로, 타임라인을 읽고 트윗에 참여할 수 있는 도구를 제공합니다. Claude 데스크톱에서 사용하도록 설계되었습니다.

특징

• 홈 타임라인에서 트윗 받기

• 새로운 트윗을 만듭니다

• 트윗에 답장하기

• 무료 API 계층에 대한 내장된 속도 제한 처리

• 완전한 유형 안전성을 갖춘 TypeScript 구현

필수 조건

• Node.js(v16 이상)

• X(트위터) 개발자 계정(무료)

• 클로드 데스크톱 앱

X API 접근

X(Twitter)는 기본 API 액세스를 위한 무료 계층을 제공합니다.

무료 티어 기능

• 게시물 제한:

  • 사용자 수준에서 월 500개의 게시물

  • 앱 수준에서 월 500개의 게시물

• 읽기 제한:

  • 한 달에 100번 읽음

• 특징:

  • v2 게시물 게시 엔드포인트에 대한 액세스

  • 미디어 업로드 엔드포인트

  • 광고 API에 대한 액세스

  • 앱 ID는 1개로 제한됩니다.

  • X 기능으로 로그인

• 요금 제한:

  • 모든 엔드포인트에 대한 속도 제한 액세스

  • 제한은 주기적으로 재설정됩니다

참고: 더 많은 양의 작업이 필요한 경우 유료 등급을 이용할 수 있습니다.

• 기본 계층($100/월): 50,000개 트윗/월, 추가 엔드포인트

• 프로 티어(월 $5000): 더 높은 한도와 엔터프라이즈 기능

무료 계층에 접속하려면 https://developer.x.com/en/portal/products/free를 방문하세요.

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 서버를 빌드하세요:

구성

X(Twitter) API 사용자 인증 정보를 설정해야 합니다. 다음 단계를 따르세요.

1. Twitter 개발자 포털 로 이동

   • X(트위터) 계정으로 로그인하세요

   • 개발자 계정이 없으면 계정을 만들라는 메시지가 표시됩니다.

2. 무료 계층에 접속하세요:

   • https://developer.x.com/en/portal/products/free 를 방문하세요

   • 무료 액세스 계층을 위해 "구독"을 클릭하세요.

   • 등록 과정을 완료하세요

3. 새로운 프로젝트를 만듭니다.

   • "프로젝트 만들기" 버튼을 클릭하세요

   • 프로젝트 이름을 입력하세요(예: "MCP 통합")

   • 설정에서 "무료"를 선택하세요

   • 사용 사례를 선택하세요

   • "다음"을 클릭하세요

4. 프로젝트 내에서 새 앱을 만듭니다.

   • "앱 만들기"를 클릭하세요

   • 앱 이름을 입력하세요

   • "설정 완료"를 클릭하세요

5. 앱 설정 구성:

   • 앱 대시보드에서 "앱 설정"을 클릭하세요.

   • "사용자 인증 설정"에서:

     • "설정"을 클릭하세요

     • OAuth 1.0a 활성화

     • "웹 앱" 또는 "네이티브 앱"을 선택하세요

     • 콜백을 위한 URL을 입력하세요(예: https://example.com/callback )

     • 웹사이트의 URL을 입력하세요(예: https://example.com )

     • "저장"을 클릭하세요

6. 앱 권한 설정:

   • 앱 설정에서 "앱 권한"을 찾으세요.

   • "읽기 및 쓰기"로 변경

   • "저장"을 클릭하세요

7. API 키와 토큰 생성:

   • "키 및 토큰" 탭으로 이동하세요

   • "소비자 키"에서:

     • "키 보기" 또는 "재생성"을 클릭하세요.

     • API 키와 API 키 비밀번호를 저장하세요

   • "액세스 토큰 및 비밀번호"에서:

     • "생성"을 클릭하세요

     • "읽기 및 쓰기" 권한이 있는 토큰을 선택해야 합니다.

     • 액세스 토큰과 액세스 토큰 비밀번호를 저장하세요

중요한:

• 키와 토큰을 안전하게 보관하고 절대로 공개적으로 공유하지 마십시오.

• 네 가지 값이 모두 필요합니다.

  • API 키(소비자 키라고도 함)

  • API 키 비밀(소비자 비밀이라고도 함)

  • 액세스 토큰

  • 액세스 토큰 비밀

• 무료 계층 한도를 기억하세요.

  • 사용자 수준에서 월 500개의 게시물

  • 앱 수준에서 월 500개의 게시물

  • 한 달에 100번 읽음

클로드 데스크톱 구성

X MCP 서버를 Claude 데스크톱에 연결하려면 Claude 설정에서 X MCP 서버를 구성해야 합니다. 다음 단계를 따르세요.

1. 파일 탐색기 열기

2. Claude 구성 디렉토리로 이동합니다.

   • Win + R을 누르세요

   • %APPDATA%/Claude 입력하고 Enter를 누릅니다.

   • Claude 폴더가 존재하지 않으면 생성하세요.

3. claude_desktop_config.json 생성하거나 편집합니다.

   • 파일이 존재하지 않으면 claude_desktop_config.json 이라는 이름의 새 파일을 만드세요.

   • 존재한다면 텍스트 편집기(예: 메모장)에서 열어보세요.

4. 이전 섹션의 실제 API 자격 증명으로 플레이스홀더 값을 바꿔서 다음 구성을 추가합니다.

5. 파일을 저장하고 Claude 데스크탑을 다시 시작하세요.

참고: 다음 사항을 확인하세요.

• 4개의 자격 증명 값을 모두 실제 API 키와 토큰으로 바꾸세요.

• 각 값 주위에 따옴표("")를 붙입니다.

• 위에 표시된 정확한 간격과 형식을 유지하세요.

• .json 확장자로 파일을 저장하세요

사용 가능한 도구

집으로 가는 시간표

홈 타임라인에서 가장 최근의 트윗을 받아보세요.

매개변수:

• limit (선택 사항): 검색할 트윗 수(기본값: 20, 최대값: 100)

예:

트윗 만들기

새로운 트윗을 작성하세요.

매개변수:

• text (필수): 트윗의 텍스트 내용(최대 280자)

예:

트윗에 답장하기

트윗에 답장합니다.

매개변수:

• tweet_id (필수): 답장할 트윗의 ID

• text (필수): 답변의 텍스트 내용 (최대 280자)

예:

개발

• npm run build : TypeScript 코드 빌드

• npm run dev : Watch 모드에서 TypeScript 실행

• npm start : MCP 서버 시작

속도 제한

서버에는 X의 무료 계층에 대한 내장된 속도 제한 처리 기능이 포함되어 있습니다.

• 월별 한도:

  • 사용자 수준에서 월 500개의 게시물

  • 앱 수준에서 월 500개의 게시물

  • 한 달에 100번 읽음

• 특징:

  • 월별 사용량을 추적합니다

  • 속도 제한 오류에 대한 지수 백오프를 제공합니다.

  • 한계에 도달하면 오류 메시지를 지웁니다.

  • 요금 제한 기간이 만료된 후 자동으로 재시도됩니다.

특허

MIT

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기