baihua-mcp-server

百花（Baihua）の機能を提供する MCP server。知識ベース検索/ノート読み取り、家計簿/タスクなどの読み取り専用機能を、標準の Model Context Protocol（stdio）ツールとして任意の MCP クライアント （Claude Desktop / Cursor / DeepSeek Harness の dsh-mcp-client など）に公開します。

百花（Baihua）について

百花 は、ローカル/LAN 向けのホームサーバーです。知識ベース（ノート全文・意味検索/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 ブリッジ（エージェントセッション + bh_* 運用 + 設定ページのステータスカード）

• baihua-local-ai-dsh-plugin — DSH → 百花ローカル AI（オンライン token の節約）

• hysteria-dsh-plugin — ローカル Hysteria 2 プロキシ管理

Related MCP server: okf-mcp-server

提供される機能

実行

接続先は環境変数で設定します（デフォルトはローカルループバック、k8s/コンテナデプロイは ClusterIP を指定）：

npm install
node src/index.js

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