Heptabase MCP

Integrations

Supports exporting Heptabase whiteboards and cards to Markdown format.
Allows exporting Heptabase whiteboard diagrams to Mermaid format for visualization.

@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

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.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

View all tools

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
Appwrite MCP Serverofficial
appwrite
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
Last updated -
84
36
Python
MIT License
MCP Kibela
kj455
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.
Last updated -
6
107
9
TypeScript
MIT License
Tiny TODO MCP
tkc
-
security
F
license
-
quality
A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
Last updated -
1
TypeScript

View all related MCP servers