███╗ ███╗ ██████╗██╗ ██╗
████╗ ████║██╔════╝╚██╗██╔╝
██╔████╔██║██║ ╚███╔╝
██║╚██╔╝██║██║ ██╔██╗
██║ ╚═╝ ██║╚██████╗██╔╝ ██╗
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝MCP-Server, der es KI-Agenten ermöglicht, Code auszuführen, anstatt Tools direkt aufzurufen.
Basiert auf Anthropic's Artikel zur Code-Ausführung.
Traditionelles MCP hat zwei Ineffizienzen:
Überlastung der Tool-Definitionen - Das Laden aller Tool-Definitionen überflutet den Kontext
Aufblähung durch Zwischenergebnisse - Jede API-Antwort durchläuft das Modell
Related MCP server: Code Executor MCP Server
Anstatt Tools direkt aufzurufen, schreibt der Agent Code, der in einer Sandbox ausgeführt wird:
const invoices = await api.getInvoices({ limit: 100 });
return {
count: invoices.length,
total: sum(invoices, 'amount'),
byStatus: count(invoices, 'status')
};
// Returns ~50 tokens instead of 50,000Ergebnis: 98% Token-Reduzierung durch Filtern von Daten innerhalb der Ausführungsumgebung.
# Install globally with bun
bun add -g @papicandela/mcx-cli
# Initialize global directory (~/.mcx/)
mcx initErfordert Bun: MCX verwendet Bun als Laufzeitumgebung. Installieren Sie Bun, falls Sie dies noch nicht getan haben.
# 1. Initialize global MCX directory
mcx init
# 2. Generate adapters from API docs
mcx gen ./api-docs.md -n myapi
# 3. Add credentials to ~/.mcx/.env
# 4. Start server
mcx serve~/.mcx/
├── adapters/ # Your adapters
│ ├── supabase.ts # Supabase Management API
│ ├── chrome-devtools.ts # Chrome DevTools Protocol
│ └── myapi.ts # Generated from OpenAPI
├── skills/ # Reusable skills
├── mcx.config.ts # Auto-loads all adapters
├── .env # API credentials
└── package.json # Dependencies
# Runtime (created automatically)
~/.mcx/
├── logs/ # Server logs (mcx logs to view)
└── .cache/ # FTS5 search indexFügen Sie dies zu Ihren Claude Code-Einstellungen hinzu (~/.claude.json oder .mcp.json des Projekts):
{
"mcpServers": {
"mcx": {
"command": "mcx",
"args": ["serve"]
}
}
}Das war's! MCX verwendet automatisch ~/.mcx/ für Konfiguration und Adapter.
Leiten Sie native Tools auf MCX-Alternativen um, um eine bessere Leistung zu erzielen:
~/.claude/settings.json:
{
"hooks": {
"PreToolUse": [
{ "matcher": "Grep", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
{ "matcher": "Glob", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
{ "matcher": "Edit", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
{ "matcher": "Write", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
{ "matcher": "Read", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-read-check.js" }] },
{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-bash-check.js" }] }
]
}
}Natives Tool | MCX-Alternative | Vorteil |
|
| Frecency-Ranking, Git-Status, Proximity-Boost |
|
| SIMD-beschleunigt, Fuzzy-Suche |
|
| Keine "Read first"-Anforderung, CRLF-Normalisierung |
|
| Keine "Read first"-Anforderung |
|
| Datei bleibt in der Sandbox, 99% Token-Einsparung |
|
| Leitet Shell-Befehle an MCX um |
Siehe Hooks Integration für Hook-Skripte.
Merkmal | Beschreibung |
Lazy Loading | Adapter aus |
Domain-Hinweise | Adapter sind nach Domänen gruppiert (Zahlungen, Datenbank, E-Mail usw.) für bessere Auffindbarkeit |
Stumme Autokorrektur |
|
Kontexteffizienz | Filterung erfolgt in der Sandbox, das Modell sieht nur die Ergebnisse |
Variablen-Persistenz | Ergebnisse als |
Auto-Kompression | Veraltete Variablen (>5min, >1KB) werden automatisch komprimiert, um Kontext zu sparen |
FTS5-Suche | Große Ausgaben werden automatisch indiziert, Suche mit |
FFF-Integration | Fast File Finder - SIMD-beschleunigte Fuzzy-Suche, Inhalts-Grep |
Hintergrundaufgaben |
|
Batch-Operationen |
|
Dateiverarbeitung |
|
Große Dateiverarbeitung | Dateien >50KB bleiben via |
Dateibearbeitung |
|
Datei-Abfrage-Helfer |
|
URL-Abruf |
|
Kontrollfluss | Schleifen, Bedingungen, Wiederholungsversuche laufen als nativer Code |
Datenschutz | Zwischenergebnisse bleiben in der Sandbox |
Sicherheit | Netzwerkisolierung, Schutz vor Pfad-Traversal, Verhinderung von Env-Injektion |
Tool | Beschreibung |
| Code mit Adapterzugriff ausführen, speichert automatisch als |
| 3 Modi: Spezifikationserkundung, FTS5-Suche, Adapter-/Methodensuche |
| Mehrere Ausführungen/Suchen in einem Aufruf (umgeht Drosselung) |
| Lokale Dateien mit |
| Dateien bearbeiten (String- oder Zeilenmodus) - umgeht die Leseanforderung von nativem Edit |
| Dateien erstellen/überschreiben - umgeht die Leseanforderung von nativem Write |
| URLs mit HTML-zu-Markdown und automatischer Indizierung abrufen (24h Cache) |
| Schnelle Fuzzy-Dateisuche mit Frecency + Proximity-Ranking |
| SIMD-beschleunigte Inhaltssuche über Dateien hinweg |
| Verwandte Dateien durch Import-/Export-Analyse finden |
| Große JSON-Ergebnisse navigieren, ohne den vollständigen Inhalt zu laden |
| Code im Hintergrund ausführen, gibt sofort Task-ID zurück |
| Hintergrundaufgaben und deren Ergebnisse auflisten/überprüfen |
| Verfügbare Adapter und Skills auflisten |
| Sitzungsstatistiken (indizierter Inhalt, Variablen, Netzwerk) |
| Diagnosen ausführen (Bun, SQLite, Adapter, Sandbox, FFF) |
| Befehl für Selbst-Upgrade auf die neueste Version abrufen |
| Einen registrierten Skill ausführen |
Befehl | Beschreibung |
| MCP-Server starten (Standard) |
| Adapter aus OpenAPI-Spezifikationen generieren (mit TUI) |
| Globales |
| CLI und globale Installation aktualisieren |
| Verfügbare Adapter und Skills auflisten |
| Einen Skill direkt ausführen |
| Server-Logs anzeigen |
Siehe CLI-Dokumentation für Details.
Adapter | Methoden | Beschreibung |
| 24 | Supabase Management API (Projekte, Tabellen, Funktionen, Secrets) |
| 25 | Chrome DevTools Protocol (Screenshots, Navigation, DOM) |
Generieren Sie Ihre eigenen Adapter aus OpenAPI-Dokumenten:
mcx gen ./api-docs.md -n myapiFunktionen, die in der Sandbox verfügbar sind:
pick(data, ['id', 'name']) // Extract fields
first(data, 5) // First N items
sum(data, 'amount') // Sum numeric field
count(data, 'status') // Count by field
table(data, 10) // Markdown table
// Async helpers
await poll(fn, { interval: 2000, maxIterations: 5 }) // Poll until done
await waitFor(fn, { timeout: 30000 }) // Wait for conditionBei Verwendung von mcx_file({ path, storeAs }) zum Laden von Dateien in die Sandbox:
// Load file without returning content to context (99% token savings)
mcx_file({ path: "src/large-file.ts", storeAs: "src" })
// Then query with helpers:
around($src, 150, 10) // 10 lines around line 150
lines($src, 100, 120) // Get lines 100-120 (1-indexed, inclusive)
block($src, 150) // Extract code block by indentation
grep($src, "TODO", 3) // Search with 3 lines context
outline($src) // Extract function/class signaturesCLI-Befehle - Detaillierte Befehlsreferenz
Adapter - Erstellen und Generieren von Adaptern
Skills - Wiederverwendbare Operationen
Konfiguration - Referenz der Konfigurationsdatei
Programmatische API - MCX im Code verwenden
Sicherheit - Sandbox-Sicherheitsebenen
git clone https://github.com/schizoidcock/mcx
cd mcx
bun install
bun run buildMIT
This server cannot be deployed
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for building and testing AI agents with multi-model experimentation and insights.
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
Analytics for MCP servers. Find out which of your tools agents get wrong. MCPulse shows you which tools AI agents retry, which come back empty, and which they never call at all. Two lines inside your own server. It never sees your arguments or your results. getmcpulse.com
