x-mcp-playwright
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 chromiumEinmaliger 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-serverClaude 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-playwright3. Tool-Katalog (9 Tools, 33 Aktionen)
x_post – Tweets veröffentlichen (6 Aktionen)
action | Required args | Description |
|
| Einen einzelnen Tweet posten |
|
| Einen verbundenen Thread posten |
|
| Bis zu 4 Bilder oder 1 Video |
|
| Auf einen Tweet antworten |
|
| Quote-Tweet mit Kommentar |
|
| Ihren Tweet löschen |
x_engage – Mit Tweets interagieren (4 Aktionen)
action | Required args |
|
|
|
|
|
|
|
|
|
|
|
|
|
x_user – Benutzeroperationen (6 Aktionen)
action | Required args | Optional |
|
| — |
|
|
|
|
|
|
|
|
|
|
| — |
|
| — |
x_search – Tweets suchen (einfach + erweitert)
arg | Default | Description |
| — | Suchbegriffe |
|
|
|
| — | Nach Autor filtern |
| — | Nach Antwort an filtern |
| — | Datumsbereich (YYYY-MM-DD) |
| 0 | Mindestanzahl an Likes |
| 0 | Mindestanzahl an Retweets |
| — | Sprachcode |
| 10 | Maximale Ergebnisse |
x_feed – Feeds durchsuchen (4 Aktionen)
action | Description |
| Ihre Start-Timeline. Optional: |
| Ihre gespeicherten Lesezeichen |
| Erwähnungen, Likes, Follower |
| Was gerade passiert |
x_tweet – Tweet-Details (4 Aktionen)
action | Required args | Description |
|
| Vollständiger Tweet mit Metriken |
|
| Antworten unter einem Tweet |
|
| Impressionen/Engagements (eigene Tweets) |
|
| Wer hat geliked/retweetet ( |
x_list – Listen
Scenario | Args |
Ihre Listen | Keine Argumente |
Listen des Benutzers |
|
List-Tweets |
|
x_dm – Direktnachrichten (3 Aktionen)
action | Required args | Description |
|
| Eine DM senden |
| — | Letzte DM-Unterhaltungen auflisten |
|
| Nachrichten mit einem Benutzer lesen |
x_session – Sitzungsverwaltung (2 Aktionen)
action | Description |
| Gibt |
| Beliebige X-Seite erfassen. Optional: |
4. Umgebungsvariablen
Variable | Default | Description |
|
|
|
|
| Standard-Playwright-Timeout (ms) |
|
| Debug-Screenshots |
|
|
|
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— Anmeldestatusx://version— Serverversionx://tools/list— Alle Toolsx://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, screenshots8. 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
This server cannot be installed
Maintenance
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).
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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