@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: Logseq MCP Tools

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

1. Installieren Sie Abhängigkeiten:

   npm install

2. 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

3. 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.