@헵타베이스/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 문제 추적기를 이용하세요.

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

A

license - permissive license

A

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

Metabase MCP Server
sazboxai
-
security
F
license
-
quality
A Model Control Protocol server that enables AI assistants to interact with Metabase databases, allowing models to explore database schemas, retrieve metadata, visualize relationships, and execute actions.
Last updated -
5
Supabase MCP Server
ninad7007
-
security
A
license
-
quality
A Model Context Protocol server that enables AI tools to interact with Supabase databases, providing tools for reading, creating, updating, and deleting records in Supabase tables.
Last updated -
MIT License
Heptabase MCP
LarryStanley
A
security
A
license
A
quality
A Model Context Protocol service that allows AI assistants to search, retrieve, analyze, and export data from Heptabase backups.
Last updated -
14
9
MIT License
MCP SQL Server
ryudg
-
security
A
license
-
quality
A Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.
Last updated -
1
2
MIT License

View all related MCP servers

Heptabase MCP