x-mcp

X(Twitter) API v2 앞에 있는 MCP 서버입니다. 이미지: ghcr.io/robertdwhite/x-mcp. whitehouse-rke2(apps/ai/x-mcp/)에 매니페스트가 있습니다.

읽기는 무료입니다. 쓰기는 2단계입니다. draft_post는 미리보기와 일회용 confirm_token을 반환하며, 정확히 해당 토큰으로 publish_post가 호출되기 전까지는 아무것도 게시되지 않습니다. 에이전트는 한 번의 호출로 게시할 수 없으므로, 사람이 볼 수 있는 미리보기가 항상 먼저 존재합니다. 이는 출력이 공개적이고 영구적일 때 중요합니다.

의도적으로 삭제 도구가 없습니다. 삭제는 파괴적이고 되돌릴 수 없으므로, X 앱에서 게시물을 삭제하세요.

도구

초안은 메모리에만 있습니다. 재시작하면 초기화되므로, 만료된 confirm 토큰이 미리보기를 보여준 프로세스보다 오래 살아남지 않습니다.

Related MCP server: pyX-MCP

엔드포인트

• POST /mcp — 스트리밍 가능한 HTTP MCP, Authorization: Bearer $MCP_TOKEN으로 게이트됨

• GET /healthz — 공개, 활성/준비 상태 확인용

다른 모든 경로는 401이 아닌 404를 반환합니다. 여기에는 MCP 클라이언트가 시작 시 수행하는 /.well-known/oauth-* 프로브도 포함됩니다. 거기서 401이 반환되면 클라이언트가 대화형 OAuth 흐름을 시도하게 되고, 헤드리스 클라이언트는 연결 시간 초과로 멈춥니다.

구성

X 인증은 OAuth 1.0a 사용자 컨텍스트이며 요청마다 서명됩니다. 앱 전용 Bearer 토큰은 게시할 수 없습니다. 게시는 계정 으로서 동작하기 때문입니다. 읽기 및 쓰기 권한이 있는 X 앱에서 네 가지 값을 가져오세요. 소비자 키와 본인 계정에 대해 생성된 액세스 토큰/비밀 쌍입니다.

자격 증명이 없으면 모든 도구는 스택 트레이스 대신 명확한 "구성되지 않음" 오류를 반환합니다. 따라서 자격 증명이 생기기 전에 서비스를 배포할 수 있습니다.

X API 요금제 참고

쓰기 액세스는 X의 유료 API 등급에 의해 제한되며, 무료 등급은 크게 제한됩니다. 이 서버의 429는 X가 제공할 때 속도 제한 재설정 시간을 표시합니다. 쓰기가 즉시 실패하면 developer.x.com에서 요금제를 확인하세요.

로컬 실행

pip install -r requirements.txt
MCP_TOKEN=dev X_API_KEY=... X_API_SECRET=... \
  X_ACCESS_TOKEN=... X_ACCESS_TOKEN_SECRET=... python server.py