Iris MCP Server
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)
Related MCP server: google-workspace-mcp-server
Installation
Voraussetzungen
Node.js 18+ und npm
Google Cloud-Projekt mit aktivierter Drive-API
OAuth 2.0-Anmeldedaten (Client-ID und Secret)
Einrichtung
Klonen und Abhängigkeiten installieren:
git clone https://github.com/continuity-bridge/iris-mcp-server.git
cd iris-mcp-server
npm installUmgebung konfigurieren:
cp .env.example .env
# Edit .env with your Google OAuth credentialsBuild:
npm run buildLokal testen:
npx @modelcontextprotocol/inspector node dist/index.jsHTTP-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 serverSiehe HTTP-MODE-GUIDE.md für die vollständige Anleitung zur Browser-Integration.
Konfiguration
Google OAuth-Einrichtung
Gehen Sie zur Google Cloud Console
Erstellen Sie ein neues Projekt oder wählen Sie ein bestehendes aus
Aktivieren Sie die Google Drive-API
Erstellen Sie OAuth 2.0-Anmeldedaten:
Anwendungstyp: Webanwendung
Autorisierte Weiterleitungs-URIs:
https://iris.uncletallest.productions/oauth/callback
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 devBuild:
npm run buildTest mit MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsRoadmap
[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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted MCP for Google Workspace, Atlassian and Notion: one OAuth, per-user accounts, write access.
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
MCP gateway and cloud hosting for MCP servers, agents and apps like RAG, managed from your agent.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive Google Drive integration through MCP, supporting file management, content operations, permission handling, commenting, version control, and shared drive management through natural language interactions.-
- AlicenseAqualityDmaintenanceMCP server for Google Workspace APIs - Docs, Sheets, Drive, Gmail, and Calendar. Enables reading, creating, and editing Google Docs and Sheets, managing comments, reading emails, and viewing calendar events.3453 npm17MIT
- AlicenseNot gradedqualityAmaintenanceEnables management of Google Drive files, Docs, Sheets, Slides, and Calendar events through natural language using the MCP protocol.5,207 npm235MIT
- AlicenseNot gradedqualityDmaintenanceEnables management of Google Drive files, Docs, Sheets, and Slides through natural language using MCP, with support for file operations, search, and shared drives.10 npmMIT