X MCP 서버
X(트위터) 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버로, 타임라인을 읽고 트윗에 참여할 수 있는 도구를 제공합니다. Claude 데스크톱에서 사용하도록 설계되었습니다.
특징
홈 타임라인에서 트윗 받기
새로운 트윗을 만듭니다
트윗에 답장하기
무료 API 계층에 대한 내장된 속도 제한 처리
완전한 유형 안전성을 갖춘 TypeScript 구현
Related MCP server: Twitter MCP Server
필수 조건
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
종속성 설치:
서버를 빌드하세요:
구성
X(Twitter) API 사용자 인증 정보를 설정해야 합니다. 다음 단계를 따르세요.
Twitter 개발자 포털 로 이동
X(트위터) 계정으로 로그인하세요
개발자 계정이 없으면 계정을 만들라는 메시지가 표시됩니다.
무료 계층에 접속하세요:
무료 액세스 계층을 위해 "구독"을 클릭하세요.
등록 과정을 완료하세요
새로운 프로젝트를 만듭니다.
"프로젝트 만들기" 버튼을 클릭하세요
프로젝트 이름을 입력하세요(예: "MCP 통합")
설정에서 "무료"를 선택하세요
사용 사례를 선택하세요
"다음"을 클릭하세요
프로젝트 내에서 새 앱을 만듭니다.
"앱 만들기"를 클릭하세요
앱 이름을 입력하세요
"설정 완료"를 클릭하세요
앱 설정 구성:
앱 대시보드에서 "앱 설정"을 클릭하세요.
"사용자 인증 설정"에서:
"설정"을 클릭하세요
OAuth 1.0a 활성화
"웹 앱" 또는 "네이티브 앱"을 선택하세요
콜백을 위한 URL을 입력하세요(예: https://example.com/callback )
웹사이트의 URL을 입력하세요(예: https://example.com )
"저장"을 클릭하세요
앱 권한 설정:
앱 설정에서 "앱 권한"을 찾으세요.
"읽기 및 쓰기"로 변경
"저장"을 클릭하세요
API 키와 토큰 생성:
"키 및 토큰" 탭으로 이동하세요
"소비자 키"에서:
"키 보기" 또는 "재생성"을 클릭하세요.
API 키와 API 키 비밀번호를 저장하세요
"액세스 토큰 및 비밀번호"에서:
"생성"을 클릭하세요
"읽기 및 쓰기" 권한이 있는 토큰을 선택해야 합니다.
액세스 토큰과 액세스 토큰 비밀번호를 저장하세요
중요한:
키와 토큰을 안전하게 보관하고 절대로 공개적으로 공유하지 마십시오.
네 가지 값이 모두 필요합니다.
API 키(소비자 키라고도 함)
API 키 비밀(소비자 비밀이라고도 함)
액세스 토큰
액세스 토큰 비밀
무료 계층 한도를 기억하세요.
사용자 수준에서 월 500개의 게시물
앱 수준에서 월 500개의 게시물
한 달에 100번 읽음
클로드 데스크톱 구성
X MCP 서버를 Claude 데스크톱에 연결하려면 Claude 설정에서 X MCP 서버를 구성해야 합니다. 다음 단계를 따르세요.
파일 탐색기 열기
Claude 구성 디렉토리로 이동합니다.
Win + R을 누르세요
%APPDATA%/Claude입력하고 Enter를 누릅니다.Claude 폴더가 존재하지 않으면 생성하세요.
claude_desktop_config.json생성하거나 편집합니다.파일이 존재하지 않으면
claude_desktop_config.json이라는 이름의 새 파일을 만드세요.존재한다면 텍스트 편집기(예: 메모장)에서 열어보세요.
이전 섹션의 실제 API 자격 증명으로 플레이스홀더 값을 바꿔서 다음 구성을 추가합니다.
파일을 저장하고 Claude 데스크탑을 다시 시작하세요.
참고: 다음 사항을 확인하세요.
4개의 자격 증명 값을 모두 실제 API 키와 토큰으로 바꾸세요.
각 값 주위에 따옴표("")를 붙입니다.
위에 표시된 정확한 간격과 형식을 유지하세요.
.json확장자로 파일을 저장하세요
사용 가능한 도구
집으로 가는 시간표
홈 타임라인에서 가장 최근의 트윗을 받아보세요.
매개변수:
limit(선택 사항): 검색할 트윗 수(기본값: 20, 최대값: 100)
예:
트윗 만들기
새로운 트윗을 작성하세요.
매개변수:
text(필수): 트윗의 텍스트 내용(최대 280자)
예:
트윗에 답장하기
트윗에 답장합니다.
매개변수:
tweet_id(필수): 답장할 트윗의 IDtext(필수): 답변의 텍스트 내용 (최대 280자)
예:
개발
npm run build: TypeScript 코드 빌드npm run dev: Watch 모드에서 TypeScript 실행npm start: MCP 서버 시작
속도 제한
서버에는 X의 무료 계층에 대한 내장된 속도 제한 처리 기능이 포함되어 있습니다.
월별 한도:
사용자 수준에서 월 500개의 게시물
앱 수준에서 월 500개의 게시물
한 달에 100번 읽음
특징:
월별 사용량을 추적합니다
속도 제한 오류에 대한 지수 백오프를 제공합니다.
한계에 도달하면 오류 메시지를 지웁니다.
요금 제한 기간이 만료된 후 자동으로 재시도됩니다.
특허
MIT
기여하다
저장소를 포크하세요
기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature)변경 사항을 커밋하세요(
git commit -m 'Add some amazing feature')브랜치에 푸시(
git push origin feature/amazing-feature)풀 리퀘스트 열기