@heptabase/mcp

Ein Model Context Protocol (MCP)-Dienst für die Interaktion mit Heptabase-Sicherungsdaten. Dieser Dienst ermöglicht KI-Assistenten wie Claude das Suchen, Abrufen, Analysieren und Exportieren von Heptabase-Whiteboards und -Karten.

Merkmale

🔍 Suche nach Whiteboards und Karten
📁 Automatische Verwaltung von Sicherungsdateien
📄 Export in mehrere Formate (Markdown, JSON, Mermaid)
🔗 Kartenbeziehungen analysieren
📊 Whiteboard-Zusammenfassungen erstellen
⚡ Intelligentes Caching für mehr Leistung

Related MCP server: Supabase MCP Server

Schnellstart

Verwendung mit Claude Desktop (empfohlen)

Am einfachsten lässt sich dieser MCP-Dienst mit Claude Desktop über npx nutzen:

{ "mcpServers": { "heptabase": { "command": "npx", "args": ["@heptabase/mcp"], "env": { "HEPTABASE_BACKUP_PATH": "/path/to/your/heptabase/backups", "HEPTABASE_AUTO_EXTRACT": "true", "HEPTABASE_WATCH_DIRECTORY": "true" } } } }

Ausführliche Einrichtungsanweisungen finden Sie unter CLAUDE_DESKTOP_NPX.md .

Lokale Entwicklung

Installieren Sie Abhängigkeiten:
npm install
Konfigurieren Sie mithilfe von Umgebungsvariablen. Erstellen Sie eine .env Datei:
HEPTABASE_BACKUP_PATH=/path/to/your/heptabase/backups HEPTABASE_AUTO_EXTRACT=true HEPTABASE_WATCH_DIRECTORY=true
Starten Sie den MCP-Server:
npm start

Grundlegende Verwendung

// Configure backup path await mcpClient.callTool({ name: "configureBackupPath", parameters: { path: "/Users/stanley/Documents/Heptabase-auto-backup" } }); // List available backups const { backups } = await mcpClient.callTool({ name: "listBackups" }); // Search for whiteboards const { whiteboards } = await mcpClient.callTool({ name: "searchWhiteboards", parameters: { query: "Project Planning" } });

Verfügbare Tools

Sicherungsverwaltung

configureBackupPath - Sicherungsverzeichnis festlegen
listBackups – Listet verfügbare Backups auf
loadBackup - Ein bestimmtes Backup laden

Suchvorgänge

searchWhiteboards - Whiteboards suchen
searchCards - Suchkarten

Datenabruf

getWhiteboard - Whiteboard-Daten abrufen
getCard - Kartendaten abrufen
getCardsByArea - Karten nach Position abrufen

Exportfunktionen

exportWhiteboard - Export in verschiedene Formate
summarizeWhiteboard - Zusammenfassungen generieren

Analysetools

analyzeGraph - Beziehungen analysieren
compareBackups - Versionen vergleichen

Entwicklung

Projektstruktur

heptabase-mcp/ ├── src/ │ ├── index.ts # MCP server │ ├── config/ # Configuration │ ├── services/ # Core services │ ├── tools/ # MCP tools │ └── types/ # TypeScript types ├── tests/ # Test files ├── package.json └── tsconfig.json

Testen

npm test

Gebäude

npm run build

Dokumentation

Eine ausführliche Dokumentation finden Sie unter SPECIFICATION.md .

Lizenz

MIT

Beitragen

Beiträge sind willkommen! Bitte lesen Sie unsere Richtlinien für Beiträge, bevor Sie PRs einreichen.

Unterstützung

Verwenden Sie für Probleme und Funktionsanfragen bitte den GitHub-Issue-Tracker.

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Heptabase MCP