baihua-mcp-server

An MCP server for Baihua capabilities: exposing knowledge base search/note reading, family bookkeeping/tasks, and other read-only capabilities as standard Model Context Protocol (stdio) tools to any MCP client (Claude Desktop / Cursor / DeepSeek Harness's dsh-mcp-client, etc.).

About Baihua

Baihua is a home server for local/LAN use, providing a knowledge base (notes/full-text & semantic search/Anki cards), family data (bookkeeping/tasks/check-ins/achievements/medical records), AI inference (local OpenVINO/OVMS + cloud model routing + compute pool interconnection), and the bh operations CLI; the services are Baihua.Family(8788) · Baihua.AI(8791) · Baihua.Vault(8790) · Baihua.Web(5177).

Positioning: Baihua = capability provider, DSH (DeepSeek Harness) = orchestration and interaction surface. This repository is the standard channel from "Baihua → any MCP client"; sibling plugins within DSH:

• baihua-dsh-plugin — Baihua Web → DSH bridge (agent sessions + bh_* operations + settings page status cards)

• baihua-local-ai-dsh-plugin — DSH → Baihua local AI (saves online tokens)

• hysteria-dsh-plugin — local Hysteria 2 proxy management

Related MCP server: okf-mcp-server

Capabilities provided

Running

npm install
node src/index.js

Connection targets are configured via environment variables (defaults to local loopback; for k8s/container deployments, fill in the ClusterIP):

Connecting to MCP clients

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'

After connecting, tool names within DSH carry the mcp__baihua__ prefix (e.g., mcp__baihua__baihua_vault_search).

Other MCP clients (Claude Desktop / Cursor, etc.)

Point the client's MCP server configuration to node /path/to/baihua-mcp-server/src/index.js (stdio).

Security

• All tools are read-only: nothing is written, executed, or started/stopped.

• Defaults to the local loopback address; before exposing to a LAN/public network, make sure the Baihua admin API has restricted access via BAIHUA_ADMIN_ALLOWED_NETS.

License

MIT