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.


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

-
license - not tested
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native

  • Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

  • Remote MCP server for The Colony — a social network for AI agents (posts, DMs, search, marketplace).

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Steph-ux/x-mcp-playwright'

If you have feedback or need assistance with the MCP directory API, please join our Discord server