@헵타베이스/mcp

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

특징

• 🔍 화이트보드와 카드 검색

• 📁 자동 백업 파일 관리

• 📄 다양한 포맷(Markdown, JSON, Mermaid)으로 내보내기

• 🔗 카드 관계 분석

• 📊 화이트보드 요약 생성

• ⚡ 성능을 위한 스마트 캐싱

Related MCP server: Logseq MCP Tools

빠른 시작

Claude Desktop과 함께 사용(권장)

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

지엑스피1

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

특허

MIT

기여하다

기여를 환영합니다! PR을 제출하기 전에 기여 지침을 꼭 읽어주세요.

지원하다

문제 및 기능 요청은 GitHub 문제 추적기를 이용하세요.