@heptabase/mcp

Heptabaseのバックアップデータと連携するためのモデルコンテキストプロトコル（MCP）サービス。このサービスにより、ClaudeのようなAIアシスタントはHeptabaseのホワイトボードやカードを検索、取得、分析、エクスポートできるようになります。

特徴

• 🔍 ホワイトボードとカードを検索する

• 📁 自動バックアップファイル管理

• 📄 複数の形式（Markdown、JSON、Mermaid）にエクスポート

• 🔗 カードの関係を分析する

• 📊 ホワイトボードの要約を生成する

• ⚡ パフォーマンスのためのスマートキャッシュ

Related MCP server: Logseq MCP Tools

クイックスタート

Claude Desktop と併用する（推奨）

この MCP サービスを使用する最も簡単な方法は、 npx経由で Claude Desktop を使用することです。

{
  "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 の問題追跡ツールを使用してください。