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

@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

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
MCP Kibela
kj455
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.
Last updated -
6
107
9
TypeScript
MIT License
Tiny TODO MCP
tkc
-
security
F
license
-
quality
A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
Last updated -
1
TypeScript
WebSearch-MCP
mnhlt
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
Last updated -
1
44
8
JavaScript

View all related MCP servers

Heptabase MCP