SiYuan MCP Server — Controla tus bases de datos con IA, sin compromisos
Contexto
SiYuan Note es una poderosa herramienta de gestión del conocimiento utilizada por miles de profesionales para organizar sus proyectos, tareas y datos en forma de bases de datos relacionales (Vistas de Atributo).
El MCP (Protocolo de Contexto del Modelo) de Anthropic permite a asistentes de IA como Claude, Cursor, etc. interactuar directamente con aplicaciones de terceros. El objetivo: hacer que SiYuan sea completamente controlable por la IA.
Problema
Los servidores MCP existentes para SiYuan gestionan documentos y bloques de texto, pero ninguno soporta las Vistas de Atributos, el sistema de base de datos relacional de SiYuan.
Específicamente:
es imposible pedirle a Claude que lea, cree o actualice una entrada en una base de datos de SiYuan. La parte más estructurada de la herramienta permaneció invisible para la IA.
es imposible pedirle a Claude que lea, cree o actualice una entrada en una base de datos de SiYuan. La parte más estructurada de la herramienta permaneció invisible para la IA.
Razón técnica:
la API HTTP oficial de SiYuan está incompleta para operaciones de escritura en Vistas de Atributos. Los datos se almacenan en archivos JSON independientes, no expuestos por puntos finales estándar.
la API HTTP oficial de SiYuan está incompleta para operaciones de escritura en Vistas de Atributos. Los datos se almacenan en archivos JSON independientes, no expuestos por puntos finales estándar.
Solución
Desarrollo de un servidor MCP completo en TypeScript, publicado como código abierto.
Enfoque técnico:
eludir la API incompleta a través de los puntos finales `/api/file/getFile` y `/api/file/putFile`, acceso directo a los archivos JSON de las bases de datos, sin acceso al sistema de archivos local. 100% HTTP, compatible con instancias remotas y Docker.
eludir la API incompleta a través de los puntos finales `/api/file/getFile` y `/api/file/putFile`, acceso directo a los archivos JSON de las bases de datos, sin acceso al sistema de archivos local. 100% HTTP, compatible con instancias remotas y Docker.
Características clave:
- Lectura completa de las bases (columnas tipadas + todas las filas)
- Creación de filas con valores iniciales
- Actualización de varias celdas en una sola llamada
- Filtrado de filas por columna/valor
- Creación de bases de datos por programación
- Soporte de 11 tipos de columnas en lectura/escritura
- Auto-descubrimiento del puerto SiYuan
Instalación sin compilación :
```bash
npx siyuan-query-mcp@latest
```
No se requiere compilación local. El usuario configura Claude Desktop en 3 líneas.
Resultado
- Paquete npm público : `siyuan-query-mcp`
- Pipeline CI/CD automatizado : 1 etiqueta git → Release GitHub + publicación npm en 16 segundos
- Comunidad SiYuan notificada
- Funcionalidad única : único servidor MCP que soporta las Attribute Views en lectura/escritura
Enlaces
GitHub : https://github.com/MyrkoF/siyuan-mcp
npm : https://www.npmjs.com/package/siyuan-query-mcp
npm : https://www.npmjs.com/package/siyuan-query-mcp
Este proyecto demuestra
- Capacidad para identificar una falta en un ecosistema de código abierto y cubrirla de forma autónoma
- Enfoque de ingeniería riguroso : análisis de la API oficial, identificación de límites, contorno técnico documentado
- Dominio del ciclo completo : desarrollo → empaquetado → publicación → automatización CI/CD → comunicación con la comunidad
- Trabajo en colaboración hombre-IA : desarrollo asistido por Claude Code, supervisión y decisiones técnicas aseguradas por el desarrollador
Etiquetas: proyectos, MCP, SiYuan, TypeScript, código abierto, IA, automatización, npm, GitHub Actions