Skip to main content
Glama
Sign In
deenesjakoruzh
x-mcp

x-mcp

by RobertDWhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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 앱에서 게시물을 삭제하세요.

도구

도구

종류

설명

whoami

읽기

자격 증명이 어떤 계정으로 동작하는지

get_tweet

읽기

ID로 게시물 하나 조회

get_user_posts

읽기

핸들의 최근 게시물

get_mentions

읽기

인증된 계정에 대한 멘션

get_home_timeline

읽기

역시간순 홈 타임라인

search_recent

읽기

최근 7일 검색(요금제에 따라 다름)

draft_post

준비

검증 + 미리보기. 아무것도 게시하지 않음.

list_drafts

읽기

준비된 초안과 남은 TTL

publish_post

쓰기

초안을 게시. 공개적이고 영구적.

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

Related MCP server: x-mcp

엔드포인트

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

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

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

구성

환경 변수

필수

용도

MCP_TOKEN

권장

/mcp의 Bearer. 설정 안 함 = 인증 없음.

X_API_KEY

예

소비자 키

X_API_SECRET

예

소비자 비밀

X_ACCESS_TOKEN

예

액세스 토큰(사용자 컨텍스트)

X_ACCESS_TOKEN_SECRET

예

액세스 토큰 비밀

X_MAX_CHARS

아니요

길이 제한, 기본 280. 프리미엄에서는 상향.

X_DRAFT_TTL

아니요

초안 수명(초), 기본 600

X_TIMEOUT

아니요

HTTP 시간 초과, 기본 30

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • TwitGhost

    arvinmoj
    A
    license
    B
    quality
    D
    maintenance
    Enables interacting with Twitter/X through natural language, including searching tweets, posting, sending DMs, and managing timelines via any MCP client.
    8
    MIT

  • x-mcp

    namank42
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with the X (Twitter) API through MCP tools for managing users, posts, bookmarks, likes, and lists. Supports markdown or JSON output and uses OAuth 2.0 PKCE authentication.
    22
    -

  • x-mcp-server

    lluisfont
    F
    license
    B
    quality
    B
    maintenance
    MCP server for the official X API, enabling agents to read and publish posts, look up users, and search posts with safe read-only default and explicit write mode.
    8
    3 npm
    -

  • x-mcp-ai

    IvanBBaev
    A
    license
    A
    quality
    B
    maintenance
    Enables MCP clients to interact with the X (Twitter) API v2 through 41 typed tools for reading, searching, engaging, publishing, and managing content, with policy-based access control and session credit budgets to prevent overspending.
    41
    74 npm
    1
    MIT