Iris MCP-Server

Multi-Backend-MCP-Gateway, das Google Drive-Schreibzugriff, Notion und mehr über einen einzigen MCP-Connector bereitstellt.

Übersicht

Iris löst die Einschränkung des kostenlosen MCP-Connectors, indem es als Gateway fungiert: Benutzer verbinden EINEN benutzerdefinierten Connector (Iris) und erhalten Zugriff auf mehrere Backend-Dienste mit vollständigen Lese-/Schreibfunktionen.

Zwei Modi:

• Stdio-Modus (Claude Desktop) - Produktionsbereit ✅

• HTTP-Modus (Browser claude.ai) - Prototyp 🧪 Siehe HTTP-MODE-GUIDE.md

Was Iris bietet

Google Drive-Backend:

• ✅ iris_drive_write - Dateien erstellen oder aktualisieren

• ✅ iris_drive_read - Dateiinhalte lesen

• ✅ iris_drive_create_folder - Ordnerstrukturen erstellen

• ✅ iris_drive_list - Dateien und Ordner auflisten

• ✅ iris_drive_move - Dateien verschieben oder umbenennen

• ✅ iris_drive_delete - Dateien löschen (mit Sicherheitsabfrage)

Demnächst verfügbar:

• Notion-Backend (Lesen + Schreiben)

• Slack-Backend (Nachrichten senden)

• Dropbox-Backend (Lesen + Schreiben)

Installation

Voraussetzungen

• Node.js 18+ und npm

• Google Cloud-Projekt mit aktivierter Drive-API

• OAuth 2.0-Anmeldedaten (Client-ID und Secret)

Einrichtung

1. Klonen und Abhängigkeiten installieren:

git clone https://github.com/continuity-bridge/iris-mcp-server.git
cd iris-mcp-server
npm install

2. Umgebung konfigurieren:

cp .env.example .env
# Edit .env with your Google OAuth credentials

3. Build:

npm run build

4. Lokal testen:

npx @modelcontextprotocol/inspector node dist/index.js

HTTP-Modus-Einrichtung (für Browser Claude.ai)

Um Iris mit dem browserbasierten claude.ai zu verwenden:

# After completing OAuth setup above
npm run setup:browser  # Interactive wizard
npm run http           # Start HTTP server

Siehe HTTP-MODE-GUIDE.md für die vollständige Anleitung zur Browser-Integration.

Konfiguration

Google OAuth-Einrichtung

1. Gehen Sie zur Google Cloud Console

2. Erstellen Sie ein neues Projekt oder wählen Sie ein bestehendes aus

3. Aktivieren Sie die Google Drive-API

4. Erstellen Sie OAuth 2.0-Anmeldedaten:

   • Anwendungstyp: Webanwendung

   • Autorisierte Weiterleitungs-URIs: https://iris.uncletallest.productions/oauth/callback

5. Kopieren Sie Client-ID und Client-Secret in die .env-Datei

Umgebungsvariablen

Siehe .env.example für alle erforderlichen Konfigurationen.

Verwendung

Multi-Instanz-Systemintegration (Anwendungsbeispiel)

Koordinierende Instanz speichert geteilte Notizen:

iris_drive_write({
  path: "coordination/shared-notes.md",
  content: "Instance A is handling task X, Instance B is tracking Y...",
  mode: "upsert"
})

Gesundheits-Tracking-Instanz speichert Wellness-Daten:

iris_drive_write({
  path: "wellness/tracking/2026-03.md",
  content: "# March 2026 Health Log\n\n## Week 1\n- Energy: 7/10\n- Sleep: 8hrs avg\n...",
  mimeType: "text/markdown"
})

Projekt-Tracking-Instanz speichert Anwendungsdaten:

iris_drive_write({
  path: "projects/applications/applied-march.md",
  content: "| Company | Position | Applied | Status |\n|---------|----------|---------|--------|\n...",
  mode: "upsert"
})

Tool-Beispiele

Ordnerstruktur erstellen:

iris_drive_create_folder({
  path: "projects/active/project-alpha"
})
// Creates: projects/ → projects/active/ → projects/active/project-alpha/

Dateien auflisten:

iris_drive_list({
  path: "coordination",
  recursive: false,
  type: "both"
})

Datei lesen:

iris_drive_read({
  path: "coordination/memory.md",
  asText: true
})

Datei verschieben:

iris_drive_move({
  sourcePath: "old-location/file.md",
  destinationPath: "new-location/file.md"
})

Datei löschen (mit Bestätigung):

iris_drive_delete({
  path: "temp/old-notes.md",
  confirm: true,
  permanent: false  // Moves to trash, not permanent
})

Architektur

Claude.ai User (Free Tier)
  ↓
  (1 Custom Connector Slot)
  ↓
Iris MCP Server
  ↓
  Google Drive API (via OAuth)
  Notion API (future)
  Slack API (future)

Entwicklung

Watch-Modus:

npm run dev

Build:

npm run build

Test mit MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Roadmap

• [x] Google Drive-Schreib-Backend

• [x] OAuth-Dashboard für Benutzerauthentifizierung

• [x] Token-Verschlüsselung und Datenbank-Speicherung

• [ ] Notion-Backend

• [ ] Slack-Backend

• [ ] Dropbox-Backend

• [ ] Benutzerverwaltungs-Dashboard

• [ ] MCP-Server-Marktplatz-Eintrag

Mitwirken

Pull Requests sind willkommen! Bitte lesen Sie zuerst CONTRIBUTING.md.

Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details

Credits

Erstellt von: Jerry Jackson (Uncle Tallest) Für: Multi-Instanz-KI-Systeme und neurodivergente KI-Zusammenarbeit

Support

• Probleme: https://github.com/continuity-bridge/iris-mcp-server/issues

• Dokumentation: https://uncletallest.productions/iris-mcp-server/docs