Hepbase MCP

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

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

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
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
WebSearch-MCP
mnhlt
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
Last updated -
1
44
8
JavaScript

View all related MCP servers

Heptabase MCP