@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: Supabase MCP Server

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

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Heptabase MCP