baihua-mcp-server

百花(Baihua) 기능의 MCP server: 지식 베이스 검색/노트 읽기, 가계부/작업 등의 읽기 전용 기능을 표준 Model Context Protocol(stdio) 도구로 모든 MCP 클라이언트 (Claude Desktop / Cursor / DeepSeek Harness의 dsh-mcp-client 등)에 노출합니다.

百花(Baihua) 소개

百花는 로컬/랜 환경을 위한 가정용 서버로, 지식 베이스(노트/전문·의미 검색/Anki 카드), 가정 데이터(가계부/작업/체크인/업적/진료 기록), AI 추론(로컬 OpenVINO/OVMS + 클라우드 모델 라우팅 + 컴퓨팅 풀 연동) 및 bh 운영 CLI를 제공합니다. 서비스 구성: Baihua.Family(8788) · Baihua.AI(8791) · Baihua.Vault(8790) · Baihua.Web(5177).

위치: 百花 = 기능 제공자, DSH(DeepSeek Harness) = 오케스트레이션 및 상호작용 계층. 이 저장소는 '百花 → 모든 MCP 클라이언트'의 표준 채널입니다. DSH 내 동일 계열 플러그인:

• baihua-dsh-plugin — 百花 Web → DSH 브리지(agent 세션 + bh_* 운영 + 설정 페이지 상태 카드)

• baihua-local-ai-dsh-plugin — DSH → 百花 로컬 AI(온라인 토큰 절약)

• hysteria-dsh-plugin — 로컬 Hysteria 2 프록시 관리

Related MCP server: okf-mcp-server

제공 기능

실행

npm install
node src/index.js

연결 대상은 환경 변수로 구성합니다(기본 로컬 루프백, k8s/컨테이너 배포 시 ClusterIP 입력):

MCP 클라이언트 연동

DeepSeek Harness(dsh-mcp-client)

# ~/.dsh/profiles/web/cordis.patch.yml → insert 列表
- id: dsh-mcp-client
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    servers:
      baihua:
        command: node
        args: ['/path/to/baihua-mcp-server/src/index.js']
        env:
          BAIHUA_VAULT_URL: 'http://127.0.0.1:8790'
          BAIHUA_FAMILY_URL: 'http://127.0.0.1:8788'

연결 후 DSH 내 도구 이름에 mcp__baihua__ 접두사가 붙습니다(예: mcp__baihua__baihua_vault_search).

기타 MCP 클라이언트(Claude Desktop / Cursor 등)

클라이언트의 MCP server 구성 방식에 따라 node /path/to/baihua-mcp-server/src/index.js(stdio)를 가리키면 됩니다.

보안

• 모든 도구는 읽기 전용: 아무것도 쓰지 않고, 실행하지 않으며, 시작/중지하지 않습니다.

• 기본적으로 로컬 루프백 주소를 가리킵니다. LAN/공개 네트워크에 노출하기 전에 百花 관리 API가 BAIHUA_ADMIN_ALLOWED_NETS에 따라 접근 범위를 제한했는지 확인하세요.

License

MIT