@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

Related MCP server: Logseq MCP Tools

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

1. Instalar dependencias:

   npm install

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

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