baihua-mcp-server

Servidor MCP para las capacidades de Baihua: expone capacidades de solo lectura como búsqueda en la base de conocimiento/lectura de notas, contabilidad familiar/tareas, etc., como herramientas estándar del Model Context Protocol (stdio) para cualquier cliente MCP (Claude Desktop / Cursor / dsh-mcp-client de DeepSeek Harness, etc.).

Acerca de Baihua

Baihua es un servidor doméstico orientado a red local/LAN que ofrece base de conocimiento (notas/búsqueda de texto completo y semántica/tarjetas Anki), datos familiares (contabilidad/tareas/check-ins/logros/registro médico), inferencia de IA (OpenVINO/OVMS local + enrutamiento de modelos en la nube + interconexión de pools de cómputo) y la CLI de operaciones bh; los servicios componen Baihua.Family(8788) · Baihua.AI(8791) · Baihua.Vault(8790) · Baihua.Web(5177).

Posicionamiento: Baihua = proveedor de capacidades, DSH (DeepSeek Harness) = capa de orquestación e interacción. Este repositorio es el canal estándar de «Baihua → cualquier cliente MCP»; plugins de la misma familia dentro de DSH:

• baihua-dsh-plugin — puente Baihua Web → DSH (sesiones de agente + operaciones bh_* + tarjetas de estado de la página de configuración)

• baihua-local-ai-dsh-plugin — DSH → IA local de Baihua (ahorra tokens en línea)

• hysteria-dsh-plugin — gestión del proxy Hysteria 2 local

Related MCP server: okf-mcp-server

Capacidades ofrecidas

Ejecución

npm install
node src/index.js

El destino de conexión se configura mediante variables de entorno (por defecto loopback local; para despliegues en k8s/contenedores, rellena la ClusterIP):

Integración con clientes 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'

Tras la integración, los nombres de las herramientas dentro de DSH llevan el prefijo mcp__baihua__ (p. ej. mcp__baihua__baihua_vault_search).

Otros clientes MCP (Claude Desktop / Cursor, etc.)

Según el método de configuración del servidor MCP del cliente, apunta a node /path/to/baihua-mcp-server/src/index.js (stdio).

Seguridad

• Todas las herramientas son de solo lectura: no escriben, no ejecutan ni inician/detienen nada.

• Por defecto apuntan a la dirección de loopback local; antes de exponerlas a la LAN/internet, confirma que la API de administración de Baihua ha restringido el alcance de acceso según BAIHUA_ADMIN_ALLOWED_NETS.

Licencia

MIT