헵타베이스 MCP

@헵타베이스/mcp

Heptabase 백업 데이터와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서비스입니다. 이 서비스를 통해 Claude와 같은 AI 비서가 Heptabase 화이트보드와 카드를 검색, 불러오기, 분석 및 내보낼 수 있습니다.

특징

🔍 화이트보드와 카드 검색
📁 자동 백업 파일 관리
📄 다양한 포맷(Markdown, JSON, Mermaid)으로 내보내기
🔗 카드 관계 분석
📊 화이트보드 요약 생성
⚡ 성능을 위한 스마트 캐싱

빠른 시작

Claude Desktop과 함께 사용(권장)

이 MCP 서비스를 사용하는 가장 쉬운 방법은 npx 통한 Claude Desktop을 이용하는 것입니다.

지엑스피1

자세한 설정 지침은 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를 참조하세요.

특허

MIT

기여하다

기여를 환영합니다! 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

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
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