Skip to main content
Glama
deenesjakoruzh
RobertDWhite

x-mcp

by RobertDWhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

x-mcp

MCP-сервер перед X (Twitter) API v2. Образ: ghcr.io/robertdwhite/x-mcp. Манифесты в whitehouse-rke2 (apps/ai/x-mcp/).

Чтение бесплатно. Запись выполняется в два шага — 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_token никогда не переживёт процесс, который показал предпросмотр.

Related MCP server: x-mcp

Эндпоинты

  • POST /mcp — streamable-HTTP MCP, требует Authorization: Bearer $MCP_TOKEN

  • GET /healthz — открыт, для проверки живости/готовности

Любой другой путь возвращает 404, а не 401 — включая зонды /.well-known/oauth-*, которые MCP-клиенты выполняют при запуске. Ответ 401 в этом случае заставляет клиенты пытаться запустить интерактивный OAuth-процесс, из-за чего headless-клиенты зависают до истечения тайм-аута соединения.

Конфигурация

Переменная

Требуется

Назначение

MCP_TOKEN

рекомендуется

Bearer-токен для /mcp. Не задан = без аутентификации.

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 с разрешением чтение и запись: потребительские ключи плюс пару токен доступа/секрет, сгенерированную для вашего собственного аккаунта.

Если учётные данные отсутствуют, каждый инструмент возвращает понятную ошибку "not configured" вместо стектрейса — поэтому сервис можно развернуть до того, как учётные данные появятся.

Примечание о тарифных планах 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 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
    6 npm
    -

  • x-mcp-ai

    IvanBBaev
    A
    license
    A
    quality
    A
    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