Hepbase MCP

Integrations

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

@hepbase/mcp

Un servicio de Protocolo de Contexto de Modelo (MCP) para interactuar con los datos de respaldo de Hepbase. Este servicio permite a asistentes de IA como Claude buscar, recuperar, analizar y exportar pizarras y tarjetas de Hepbase.

Características

🔍Buscar pizarras y tarjetas
📁 Gestión automática de archivos de respaldo
📄 Exportar a múltiples formatos (Markdown, JSON, Mermaid)
🔗 Analizar las relaciones entre las tarjetas
📊 Generar resúmenes de pizarra
⚡ Almacenamiento en caché inteligente para un mejor rendimiento

Inicio rápido

Uso con Claude Desktop (recomendado)

La forma más sencilla de utilizar este servicio MCP es con Claude Desktop a través de npx :

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

Consulte CLAUDE_DESKTOP_NPX.md para obtener instrucciones de configuración detalladas.

Desarrollo local

Instalar dependencias:
npm install
Configurar mediante variables de entorno. Crear un archivo .env :
HEPTABASE_BACKUP_PATH=/path/to/your/heptabase/backups HEPTABASE_AUTO_EXTRACT=true HEPTABASE_WATCH_DIRECTORY=true
Inicie el servidor MCP:
npm start

Uso básico

// 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"
  }
});

Herramientas disponibles

Gestión de copias de seguridad

configureBackupPath - Establecer directorio de respaldo
listBackups - Lista de copias de seguridad disponibles
loadBackup - Cargar una copia de seguridad específica

Operaciones de búsqueda

searchWhiteboards - Buscar pizarras
searchCards - Tarjetas de búsqueda

Recuperación de datos

getWhiteboard - Obtener datos de la pizarra
getCard - Obtener datos de la tarjeta
getCardsByArea - Obtener tarjetas por posición

Funciones de exportación

exportWhiteboard - Exportación a varios formatos
summarizeWhiteboard - Generar resúmenes

Herramientas de análisis

analyzeGraph : Analizar relaciones
compareBackups - Comparar versiones

Desarrollo

Estructura del proyecto

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

Pruebas

npm test

Edificio

npm run build

Documentación

Para obtener documentación detallada, consulte SPECIFICATION.md .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! Lea nuestras normas de contribución antes de enviar sus solicitudes de colaboración.

Apoyo

Para problemas y solicitudes de funciones, utilice el rastreador de problemas de GitHub.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

View all tools

Un servicio de protocolo de contexto de modelo que permite a los asistentes de IA buscar, recuperar, analizar y exportar datos de las copias de seguridad de Hepbase.

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

Heptabase MCP