convez.ai
MCP ServerIntegração & APIsIntermediário
Lancernix

SiYuan MCP Server

Lancernix/siyuan-mcp

Integre IA com seu SiYuan Note via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra aplicações de IA com o SiYuan Note, permitindo leitura, criação e manipulação programática de notas. Oferece ferramentas de baixo nível para operações atômicas e ferramentas compostas de alto nível para buscas inteligentes e gerenciamento de conteúdo.

Instalação

$npx convez-ai Lancernix/siyuan-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 4 meses
Versão
v1.4.0
Issues abertas
0
Contribuidores
3

Casos de uso

  • Sincronizar notas do SiYuan com fluxos de automação de IA
  • Buscar e recuperar conteúdo de notas programaticamente
  • Criar e atualizar notas automaticamente a partir de requisições do Claude
  • Gerenciar estrutura de notebooks e documentos via API

Veredito

MCP server bem estruturado para SiYuan Note com cobertura completa de operações (notebooks, documentos, blocos, consultas). Implementação em TypeScript com bom suporte CI/CD e ferramentas de alto nível prontas para uso.

README

A tradução para o português deste README ainda está na fila.

SiYuan MCP

An MCP (Model Context Protocol) server for SiYuan Note, enabling AI applications to seamlessly interact with your notes.

Installation

pnpm add siyuan-mcp

Development

git clone https://github.com/Lancernix/siyuan-mcp.git
cd siyuan-mcp
pnpm install
pnpm run dev

Start the server

pnpm start

Lint and type check

pnpm run check

Format code

pnpm run lint

Build

pnpm run build

Configuration

Create a .env.local file with the following variables:

SIYUAN_API_URL=http://127.0.0.1:6806
SIYUAN_API_TOKEN=your-api-token-here
  • SIYUAN_API_URL - SiYuan API endpoint (default: http://127.0.0.1:6806)
  • SIYUAN_API_TOKEN - SiYuan API authentication token (required)

Tools

Atomic Tools (low-level API wrappers)

Notebooks - list_notebooks, open_notebook, close_notebook, rename_notebook, create_notebook, remove_notebook, get_notebook_conf, set_notebook_conf

Documents - create_doc, rename_doc, remove_doc, move_docs, get_hpath_by_path, get_hpath_by_id, get_ids_by_hpath, get_path_by_id, rename_doc_by_id, remove_doc_by_id, move_docs_by_id

Blocks - insert_block, prepend_block, append_block, update_block, delete_block, move_block, get_block_kramdown, get_child_blocks, fold_block, unfold_block, transfer_block_ref

Attributes - get_block_attrs, set_block_attrs

Query - sql_query, flush_transaction, export_md_content

Files - get_file, put_file, remove_file, read_dir, rename_file

Attribute Views - render_attribute_view, get_attribute_view, get_av_primary_key_values, search_attribute_view, get_av_filter_sort, set_av_block_attr, add_av_blocks, remove_av_blocks, add_av_key, remove_av_key, change_av_layout, set_av_filters, set_av_group, set_av_sorts, sort_av_key, sort_av_view_key

System - system_status, system_version, workspace_info, get_current_time

Composite Tools (high-level)

  • smart_create_note - Smartly create a note (auto-match notebook and path)
  • upsert_note_content - Update or create note content
  • get_todos - Get uncompleted todo items (- [ ] syntax)
  • find_note - Search document titles by keyword
  • smart_search - Smart search across document titles and content

CI/CD

PR Checks (feature.yaml)

  • Code formatting (Biome)
  • TypeScript type checking
  • Build verification

Release (main.yaml)

  • Automatic versioning with semantic-release
  • Publish to NPM

License

MIT

Ver o original no GitHub

Bom para

Relacionados