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

Metabase MCP Server
sazboxai
-
security
F
license
-
quality
A Model Control Protocol server that enables AI assistants to interact with Metabase databases, allowing models to explore database schemas, retrieve metadata, visualize relationships, and execute actions.
Last updated -
4
Python
Supabase MCP Server
ninad7007
-
security
A
license
-
quality
A Model Context Protocol server that enables AI tools to interact with Supabase databases, providing tools for reading, creating, updating, and deleting records in Supabase tables.
Last updated -
Python
MIT License
Heptabase MCP
LarryStanley
A
security
A
license
A
quality
A Model Context Protocol service that allows AI assistants to search, retrieve, analyze, and export data from Heptabase backups.
Last updated -
14
7
TypeScript
MIT License
MCP SQL Server
ryudg
-
security
A
license
-
quality
A Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.
Last updated -
4
2
TypeScript
MIT License

View all related MCP servers

Heptabase MCP