X MCP Server

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. 풀 리퀘스트 열기