MCP Tool Hub

Ein modularer, erweiterbarer Model Context Protocol-Multi-Server-Hub — entwickelt in TypeScript für IT-Automatisierungsteams.

Ermöglichen Sie Ihrem LLM den Zugriff auf reale Werkzeuge: Dateien, Git, Webinhalte und persistenten Speicher. Stellen Sie die Lösung über Ansible gleichzeitig auf einer beliebigen Anzahl von Client-Maschinen bereit.

Architektur

mcp-tool-hub/
├── packages/
│   ├── core/              ← Shared types + BaseMCPServer abstract class
│   ├── server-filesystem/ ← Sandboxed local file access (read/write/list/delete)
│   ├── server-git/        ← Git log, diff, file contents, branches, status
│   ├── server-fetch/      ← Web fetching: HTML, JSON APIs, URL health checks
│   └── server-memory/     ← Persistent JSON knowledge base (survives restarts)
├── host/                  ← Orchestrator: registry + CLI + stdio JSON interface
├── ansible/               ← Playbook, inventory, systemd service templates
└── docs/                  ← How to add new servers (with template)

Die Architektur folgt dem Model Context Protocol-Muster:

• Jeder Server ist vollständig unabhängig — eigenes Paket, eigener Build

• Die Registry im Host bildet zur Laufzeit toolName → server ab

• Das CLI stellt eine stdio-JSON-Schnittstelle bereit — jede LLM-Integration sendet {"toolName":"...", "arguments":{...}} an stdin und liest das Ergebnis von stdout

• Einen neuen Server hinzufügen = Paket erstellen, BaseMCPServer erweitern, in cli.ts registrieren

Related MCP server: mcp-toolbox

Schnellstart

1. Installieren & Bauen

git clone https://github.com/your-org/mcp-tool-hub.git
cd mcp-tool-hub
npm install
npm run build

2. Konfigurieren

cp .env.example .env
# Edit .env with your paths and settings

3. Ausführen

# Via npm
npm run start --workspace=host

# Or directly
node host/dist/cli.js

4. Ein Tool aufrufen

Senden Sie JSON an stdin, erhalten Sie JSON von stdout:

echo '{"toolName":"read_file","arguments":{"path":"hello.txt"}}' | node host/dist/cli.js

Verfügbare Tools

📁 Filesystem Server

Alle Operationen sind auf MCP_FS_ROOT beschränkt (Sandbox). Pfad-Traversal (../) ist blockiert.

🔀 Git Server

Nur lesend. Keine Schreiboperationen.

🌐 Fetch Server

Unterstützt eine optionale Domain-Whitelist über MCP_FETCH_ALLOWED_DOMAINS.

🧠 Memory Server

Persistent über Neustarts hinweg. Basiert auf einer JSON-Datei.

Ansible-Bereitstellung

Bereitstellung auf allen Ihren Client-Maschinen gleichzeitig:

cd ansible

# First time
ansible-playbook -i inventory.yml deploy-mcp-hub.yml

# Update only (rebuild + restart)
ansible-playbook -i inventory.yml deploy-mcp-hub.yml --tags update

# Deploy to specific group
ansible-playbook -i inventory.yml deploy-mcp-hub.yml --limit servers

Das Playbook:

1. Installiert Node.js 20 (falls nicht vorhanden)

2. Erstellt einen dedizierten mcp-hub-Systembenutzer

3. Kopiert und baut das Projekt

4. Schreibt die .env-Konfiguration aus Ihren Ansible-Variablen

5. Installiert und startet einen systemd-Dienst (automatischer Neustart bei Fehler)

Host-spezifische Variablen in inventory.yml ermöglichen es Ihnen, unterschiedliche erlaubte Domains, Log-Level und Pfade pro Maschinengruppe zu konfigurieren.

Einen neuen Server hinzufügen

Siehe docs/adding-a-new-server.template.ts für die vollständige Vorlage mit Kommentaren.

Kurz gesagt:

// 1. Create packages/server-myservice/src/my-server.ts
export class MyServer extends BaseMCPServer {
  constructor(options: MyOptions) {
    super(SERVER_INFO, options);
    this.registerTool("my_tool", this.handleMyTool.bind(this));
  }
  private async handleMyTool(args) {
    return this.ok({ result: "done" });
  }
}

// 2. Register in host/src/cli.ts
hub.use(new MyServer({ apiKey: process.env.MY_API_KEY! }));

Ideen: server-slack, server-postgres, server-docker, server-ansible, server-ssh, server-jira

Umgebungsvariablen

Sicherheitshinweise

• Dateisystem: Streng isoliert (Sandbox). Pfad-Traversal-Angriffe führen zu einem Fehler, nicht zur Datenherausgabe.

• Git: Nur lesend. Keine commit-, push- oder clone-Operationen verfügbar.

• Fetch: Optionale Domain-Whitelist verhindert SSRF zu internen Diensten.

• Systemd-Dienst: Läuft als Nicht-Root-Benutzer mit PrivateTmp=true und NoNewPrivileges=true.

Anforderungen

• Node.js ≥ 18 (für native fetch-API)

• Git (für server-git)

• Linux mit systemd (für Ansible-Bereitstellung)