ヘプタベースMCP

Integrations

Allows exporting Heptabase whiteboards and cards to Markdown format
Supports exporting Heptabase whiteboards to Mermaid diagrams for visual representation

@heptabase/mcp

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

特徴

🔍 ホワイトボードとカードを検索する
📁 自動バックアップファイル管理
📄 複数の形式（Markdown、JSON、Mermaid）にエクスポート
🔗 カードの関係を分析する
📊 ホワイトボードの要約を生成する
⚡ パフォーマンスのためのスマートキャッシュ

クイックスタート

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参照してください。

地域開発

依存関係をインストールします:
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 の問題追跡ツールを使用してください。

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

View all tools

AI アシスタントが 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
Amadeus MCP Server
privilegemendes
A
security
F
license
A
quality
A Model Context Protocol server that connects to Amadeus API, enabling AI assistants to search flights, analyze prices, find best travel deals, and plan multi-city trips.
Last updated -
294
TypeScript

View all related MCP servers

Heptabase MCP