Skip to main content
Glama

@heptabase/mcp

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

特徴

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

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

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

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

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

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

Related MCP server: Supabase MCP Server

クイックスタート

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/LarryStanley/heptabse-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server