Skip to main content
Glama

Heptabase MCP

by LarryStanley

@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

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.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Ein Model Context Protocol-Dienst, der es KI-Assistenten ermöglicht, Daten aus Heptabase-Backups zu suchen, abzurufen, zu analysieren und zu exportieren.

  1. Merkmale
    1. Schnellstart
      1. Verwendung mit Claude Desktop (empfohlen)
      2. Lokale Entwicklung
      3. Grundlegende Verwendung
    2. Verfügbare Tools
      1. Sicherungsverwaltung
      2. Suchvorgänge
      3. Datenabruf
      4. Exportfunktionen
      5. Analysetools
    3. Entwicklung
      1. Projektstruktur
      2. Testen
      3. Gebäude
    4. Dokumentation
      1. Lizenz
        1. Beitragen
          1. Unterstützung

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              A Model Control Protocol server that enables AI assistants to interact with Metabase databases, allowing models to explore database schemas, retrieve metadata, visualize relationships, and execute actions.
              Last updated -
              5
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI tools to interact with Supabase databases, providing tools for reading, creating, updating, and deleting records in Supabase tables.
              Last updated -
              MIT License
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol service that allows AI assistants to search, retrieve, analyze, and export data from Heptabase backups.
              Last updated -
              14
              9
              MIT License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.
              Last updated -
              1
              2
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/LarryStanley/heptabse-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server