@heptabase/mcp

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

Функции

• 🔍 Поиск досок и карточек

• 📁 Автоматическое управление файлами резервного копирования

• 📄 Экспорт в несколько форматов (Markdown, JSON, Mermaid)

• 🔗 Анализируйте взаимосвязи карт

• 📊 Создавайте сводки на доске

• ⚡ Умное кэширование для производительности

Related MCP server: Logseq MCP Tools

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

Использование с 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

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

1. Установить зависимости:

   npm install

2. Настройте с помощью переменных среды. Создайте файл .env :

   HEPTABASE_BACKUP_PATH=/path/to/your/heptabase/backups
   HEPTABASE_AUTO_EXTRACT=true
   HEPTABASE_WATCH_DIRECTORY=true

3. Запустите 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.