1MCP - Ein MCP-Server für alle

Eine einheitliche Model Context Protocol-Serverimplementierung, die mehrere MCP-Server zu einem einzigen zusammenfasst.

NPM-Version NPM-Lizenz Schmiedeabzeichen

Überblick

1MCP (One MCP) vereinfacht die Arbeit mit KI-Assistenten. Anstatt mehrere MCP-Server für verschiedene Clients (Claude Desktop, Cherry Studio, Cursor, Roo Code, Claude usw.) zu konfigurieren, bietet 1MCP einen einzigen, einheitlichen Server, der:

Aggregiert mehrere MCP-Server in einer einheitlichen Schnittstelle
Reduziert die Nutzung von Systemressourcen durch die Eliminierung redundanter Serverinstanzen
Vereinfacht das Konfigurationsmanagement verschiedener KI-Assistenten
Bietet eine standardisierte Möglichkeit für KI-Modelle, mit externen Tools und Ressourcen zu interagieren
Unterstützt dynamisches Neuladen der Konfiguration ohne Serverneustart
Verwaltet ordnungsgemäßes Herunterfahren und Bereinigung der Ressourcen

Related MCP server: MCP Starter

Schnellstart

Um Cursor die Verwendung vorhandener MCP-Server zu ermöglichen, die bereits in Claude Desktop konfiguriert sind, führen Sie die folgenden Schritte aus:

Führen Sie den 1MCP-Server mit der Claude Desktop-Konfigurationsdatei aus:

npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json

Fügen Sie den 1MCP-Server zu Ihrer Cursor-Konfigurationsdatei ( ~/.cursor/mcp.json ) hinzu:

{ "mcpServers": { "1mcp": { "type": "http", "url": "http://localhost:3050/sse" } } }

Genießen Sie es!

Verwendung

Sie können den Server direkt mit npx ausführen:

# Basic usage (starts server with SSE transport) npx -y @1mcp/agent # Use existing Claude Desktop config npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json # Use stdio transport instead of SSE npx -y @1mcp/agent --transport stdio # Show all available options npx -y @1mcp/agent --help

Verfügbare Optionen:

--transport, -t : Transporttyp auswählen ("stdio" oder "http", Standard: "http")
--config, -c : Verwenden Sie eine bestimmte Konfigurationsdatei
--port, -P : HTTP-Port ändern (Standard: 3050)
--host, -H : HTTP-Host ändern (Standard: localhost)
--tags, -g : Server nach Tags filtern (siehe Abschnitt „Tags“ weiter unten)
--help, -h : Hilfe anzeigen

Beispiel mit Umgebungsvariablen:

# Using environment variables ONE_MCP_PORT=3051 ONE_MCP_TAGS=network,filesystem npx -y @1mcp/agent # Or in your shell configuration export ONE_MCP_PORT=3051 export ONE_MCP_TAGS=network,filesystem npx -y @1mcp/agent

Docker

Sie können 1MCP auch mit Docker ausführen:

# Pull the latest image docker pull ghcr.io/1mcp-app/agent:latest # Run with HTTP transport (default) docker run -p 3050:3050 ghcr.io/1mcp-app/agent # Run with a custom config file docker run -p 3050:3050 -v /path/to/config.json:/config.json ghcr.io/1mcp-app/agent --config /config.json # Run with stdio transport docker run -i ghcr.io/1mcp-app/agent --transport stdio

Verfügbare Bild-Tags:

latest : Neueste stabile Version
vX.YZ : Bestimmte Version (zB v1.0.0 )
sha-<commit> : Spezifisches Commit

Umgebungsvariablen

Sie können 1MCP mithilfe von Umgebungsvariablen mit dem Präfix ONE_MCP_ konfigurieren:

ONE_MCP_TRANSPORT : Transporttyp („stdio“ oder „http“, Standard: „http“)
ONE_MCP_PORT : HTTP-Port (Standard: 3050)
ONE_MCP_HOST : HTTP-Host (Standard: „localhost“)
ONE_MCP_CONFIG : Pfad zur Konfigurationsdatei
ONE_MCP_TAGS : Komma-getrennte Liste von Tags zum Filtern von Servern

Beispiel mit Umgebungsvariablen:

docker run -p 3051:3051 \ -e ONE_MCP_PORT=3051 \ -e ONE_MCP_TAGS=network,filesystem \ ghcr.io/1mcp-app/agent

Tags verstehen

Mithilfe von Tags können Sie steuern, welche MCP-Server für welche Clients verfügbar sind. Stellen Sie sich Tags als Beschriftungen vor, die beschreiben, was jeder Server tun kann.

So verwenden Sie Tags

In Ihrer Serverkonfiguration : Fügen Sie jedem Server Tags hinzu, um seine Fähigkeiten zu beschreiben

{ "mcpServers": { "web-server": { "command": "uvx", "args": ["mcp-server-fetch"], "tags": ["network", "web"], "disabled": false }, "file-server": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Downloads"], "tags": ["filesystem"], "disabled": false } } }

Beim Starten von 1MCP im Standardmodus : Sie können Server nach Tags filtern

# Only start servers with the "network" tag npx -y @1mcp/agent --transport stdio --tags "network" # Start servers with either "network" or "filesystem" tags npx -y @1mcp/agent --transport stdio --tags "network,filesystem"

Bei Verwendung von SSE-Transport : Clients können Server mit bestimmten Tags anfordern

{ "mcpServers": { "1mcp": { "type": "http", "url": "http://localhost:3050/sse?tags=network" // Only connect to network-capable servers } } }

Beispiel-Tags:

network : Für Server, die Webanforderungen stellen
filesystem : Für Server, die Dateioperationen verarbeiten
memory : Für Server, die Speicher/Speicherplatz bereitstellen
shell : Für Server, die Shell-Befehle ausführen
db : Für Server, die Datenbankoperationen verarbeiten

Konfiguration

Globale Konfiguration

Der Server verwaltet die Konfiguration automatisch an einem globalen Standort:

macOS/Linux: ~/.config/1mcp/mcp.json
Windows: %APPDATA%/1mcp/mcp.json

Konfigurationsdateiformat

{ "mcpServers": { "mcp-server-fetch": { "command": "uvx", "args": [ "mcp-server-fetch" ], "disabled": false }, "server-memory": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-memory" ], "disabled": false } } }

Wie es funktioniert

Systemarchitektur

Anforderungsfluss

sequenceDiagram participant Client as AI Assistant participant 1MCP as 1MCP Server participant MCP as MCP Servers Client->>1MCP: Send MCP Request activate 1MCP 1MCP->>1MCP: Validate Request 1MCP->>1MCP: Load Config 1MCP->>MCP: Forward Request activate MCP MCP-->>1MCP: Response deactivate MCP 1MCP-->>Client: Forward Response deactivate 1MCP

Entwicklung

Installieren Sie Abhängigkeiten:

pnpm install

Erstellen Sie den Server:

pnpm build

Für die Entwicklung mit automatischem Rebuild:

pnpm watch

Führen Sie den Server aus:

pnpm dev

Debuggen

Verwenden des MCP Inspector , der als Paketskript verfügbar ist:

pnpm inspector

Der Inspector stellt eine URL für den Zugriff auf Debugging-Tools in Ihrem Browser bereit.

1MCP Server