Гептабаза МЦП

@heptabase/mcp

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

Функции

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

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

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

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

Служба протокола контекста модели, которая позволяет помощникам с искусственным интеллектом искать, извлекать, анализировать и экспортировать данные из резервных копий Heptabase.

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