Skip to main content
Glama
Steph-ux

x-mcp-playwright

by Steph-ux

x-mcp-playwright

Ein Twitter/X MCP-Server, unterstützt von patchright (einem stealth Playwright-Fork) und einem persistenten Chrome-Benutzerprofil.

9 gruppierte Tools – 33 Aktionen erhalten, keine Funktionalität verloren.


1. Installation

git clone <this-repo> x-mcp-playwright
cd x-mcp-playwright

python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

pip install -e .
patchright install chromium

Einmaliger Login

x-mcp-login
# or: python login.py

Öffnet ein echtes Browserfenster. Melden Sie sich normal bei X an und schließen Sie dann das Fenster. Die Sitzung wird in ~/.x-mcp-playwright/profile/ gespeichert.


Related MCP server: X MCP Server

2. In Ihrem MCP-Client registrieren

Claude Code

claude mcp add --scope user x-twitter x-mcp-server

Claude Desktop

{
  "mcpServers": {
    "x-twitter": {
      "command": "x-mcp-server",
      "env": { "X_MCP_HEADLESS": "1" }
    }
  }
}

Wenn x-mcp-server nicht im PATH ist, verwenden Sie:

{
  "mcpServers": {
    "x-twitter": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "x_mcp_server"]
    }
  }
}

Docker (headless VPS)

docker build -t x-mcp-playwright .
docker run -i --rm \
  -v ~/.x-mcp-playwright/profile:/root/.x-mcp-playwright/profile \
  x-mcp-playwright

3. Tool-Katalog (9 Tools, 33 Aktionen)

x_post – Tweets veröffentlichen (6 Aktionen)

action

Required args

Description

post

text

Einen einzelnen Tweet posten

thread

tweets (newline-separated)

Einen verbundenen Thread posten

post_media

text, media_paths (comma-separated)

Bis zu 4 Bilder oder 1 Video

reply

tweet_url, reply_text

Auf einen Tweet antworten

quote

tweet_url, comment

Quote-Tweet mit Kommentar

delete

tweet_url

Ihren Tweet löschen

x_engage – Mit Tweets interagieren (4 Aktionen)

action

Required args

on param

like

tweet_url

on=True zum Liken, False zum Entliken

retweet

tweet_url

on=True zum Retweeten, False zum Rückgängig machen

bookmark

tweet_url

on=True zum Speichern, False zum Entfernen

pin

tweet_url

on=True zum Anheften, False zum Lösen

x_user – Benutzeroperationen (6 Aktionen)

action

Required args

Optional

profile

handle

—

timeline

handle

tab="tweets"|"likes"|"media", limit

connections

handle

kind="followers"|"following", limit

follow

handle

on=True zum Folgen, False zum Entfolgen

block

handle

—

mute

handle

—

arg

Default

Description

query

—

Suchbegriffe

filter

"top"

"latest", "people", "media"

from_user

—

Nach Autor filtern

to_user

—

Nach Antwort an filtern

since / until

—

Datumsbereich (YYYY-MM-DD)

min_likes

0

Mindestanzahl an Likes

min_retweets

0

Mindestanzahl an Retweets

lang

—

Sprachcode

limit

10

Maximale Ergebnisse

x_feed – Feeds durchsuchen (4 Aktionen)

action

Description

home

Ihre Start-Timeline. Optional: tab="for_you"|"following"

bookmarks

Ihre gespeicherten Lesezeichen

notifications

Erwähnungen, Likes, Follower

trending

Was gerade passiert

x_tweet – Tweet-Details (4 Aktionen)

action

Required args

Description

details

tweet_url

Vollständiger Tweet mit Metriken

replies

tweet_url

Antworten unter einem Tweet

analytics

tweet_url

Impressionen/Engagements (eigene Tweets)

engagers

tweet_url

Wer hat geliked/retweetet (kind="likes"|"retweets")

x_list – Listen

Scenario

Args

Ihre Listen

Keine Argumente

Listen des Benutzers

handle

List-Tweets

list_id

x_dm – Direktnachrichten (3 Aktionen)

action

Required args

Description

send

handle, message

Eine DM senden

conversations

—

Letzte DM-Unterhaltungen auflisten

messages

handle

Nachrichten mit einem Benutzer lesen

x_session – Sitzungsverwaltung (2 Aktionen)

action

Description

check

Gibt {logged_in, current_url, user_handle} zurück

screenshot

Beliebige X-Seite erfassen. Optional: url, full_page


4. Umgebungsvariablen

Variable

Default

Description

X_MCP_HEADLESS

1

0 um das Browserfenster zu sehen

X_MCP_TIMEOUT_MS

20000

Standard-Playwright-Timeout (ms)

X_MCP_SCREENSHOT_DIR

~/.x-mcp-playwright/screenshots

Debug-Screenshots

X_MCP_USE_SYSTEM_CHROME

0

1 um systemisches Chrome zu verwenden


5. Sicherheit

  • Ratenbegrenzer: Schreibaktionen (post, delete, DM, reply) auf 1/min begrenzt. Interaktionsaktionen (like, RT, follow) auf 2/min begrenzt. Leseaktionen unbegrenzt.

  • Sitzungs-Keepalive: Hintergrundaufgabe pingt X alle 30 Minuten. Protokolliert eine Warnung, wenn die Sitzung abläuft.

  • An Ihr echtes Konto gebunden. Alles, was das LLM tut, haben Sie getan.


6. MCP-Ressourcen

  • x://session/status — Anmeldestatus

  • x://version — Serverversion

  • x://tools/list — Alle Tools

  • x://tools/categories — Gruppierte Taxonomie

7. MCP-Prompts

  • analyze_tweet(tweet_url) — Tweet abrufen und analysieren (Stimmung, Engagement, Antwortton)

  • draft_reply(tweet_url, intent) — 3 Antwortvarianten unter 280 Zeichen entwerfen


7. Entwicklung

make install     # deps + chromium
make login       # interactive X login
make test        # unit tests (no browser)
make smoke       # live search test
make server      # run MCP server
make lint        # compile-check
make clean       # remove pycache, screenshots

8. Sicherheit

  • An Ihr echtes Konto gebunden. Alles, was das LLM tut, haben Sie getan.

  • Begrenzung: <= 1-2 Veröffentlichungs-/Antwortaktionen pro Minute.

  • Sperren Sie destruktive Tools (delete, block, send_dm) hinter menschlicher Genehmigung auf VPS.


Lizenz

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    F
    maintenance
    A local MCP server that exposes the X API (formerly Twitter API) as tools, enabling operations like posting, searching, user management, and more via natural language commands.
    865
    -
  • A
    license
    B
    quality
    D
    maintenance
    MCP server for interacting with the X platform (Twitter) via MCP clients like Claude, Cursor AI, and Windsurf AI.
    20
    5 npm
    6
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides programmatic X (Twitter) engagement via MCP, offering 24 tools for search, timelines, notifications, bookmarks, profiles, and tweet actions through a headless browser.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for the Twitter/X API, enabling search, user profiles, tweets, followers, and more via natural language.
    94
    286 npm
    4
    MIT