用于与 Heptabase 备份数据交互的模型上下文协议 (MCP) 服务。该服务允许像 Claude 这样的 AI 助手搜索、检索、分析和导出 Heptabase 白板和卡片。
🔍 搜索白板和卡片
📁 自动备份文件管理
📄 导出为多种格式（Markdown、JSON、Mermaid）
🔗 分析卡片关系
📊 生成白板摘要
⚡ 智能缓存以提高性能
Related MCP server: Logseq MCP Tools
使用此 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.jsonnpm testnpm run build有关详细文档，请参阅SPECIFICATION.md 。
麻省理工学院
欢迎贡献！提交 PR 之前，请阅读我们的贡献指南。
对于问题和功能请求，请使用 GitHub 问题跟踪器。
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/LarryStanley/heptabase-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server