@heptabase/mcp

Служба Model Context Protocol (MCP) для взаимодействия с резервными данными Heptabase. Эта служба позволяет помощникам ИИ, таким как Клод, искать, извлекать, анализировать и экспортировать доски и карточки Heptabase.

Функции

🔍 Поиск досок и карточек
📁 Автоматическое управление файлами резервного копирования
📄 Экспорт в несколько форматов (Markdown, JSON, Mermaid)
🔗 Анализируйте взаимосвязи карт
📊 Создавайте сводки на доске
⚡ Умное кэширование для производительности

Related MCP server: Supabase MCP Server

Быстрый старт

Использование с Claude Desktop (рекомендуется)

Самый простой способ использовать эту службу MCP — с помощью Claude Desktop через 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" } } } }

Подробные инструкции по настройке см. в CLAUDE_DESKTOP_NPX.md

Местное развитие

Установить зависимости:
npm install
Настройте с помощью переменных среды. Создайте файл .env :
HEPTABASE_BACKUP_PATH=/path/to/your/heptabase/backups HEPTABASE_AUTO_EXTRACT=true HEPTABASE_WATCH_DIRECTORY=true
Запустите MCP-сервер:
npm start

Базовое использование

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

Доступные инструменты

Управление резервным копированием

configureBackupPath — установка каталога для резервного копирования
listBackups — список доступных резервных копий
loadBackup — загрузить определенную резервную копию

Поисковые операции

searchWhiteboards - Поиск досок
searchCards - Поиск карт

Извлечение данных

getWhiteboard — Получить данные с доски
getCard - Получить данные карты
getCardsByArea - Получить карты по позиции

Экспортные функции

exportWhiteboard - Экспорт в различные форматы
summarizeWhiteboard - Создание резюме

Инструменты анализа

analyzeGraph - Анализ взаимосвязей
compareBackups - Сравнение версий

Разработка

Структура проекта

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

Тестирование

npm test

Здание

npm run build

Документация

Подробную документацию см. в SPECIFICATION.md .

Лицензия

Массачусетский технологический институт

Внося вклад

Вклады приветствуются! Пожалуйста, ознакомьтесь с нашими правилами по вкладам перед отправкой PR.

Поддерживать

Для сообщений о проблемах и запросов на новые функции используйте систему отслеживания ошибок GitHub.

One-click Deploy

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