convez.ai
MCP ServerIntegração & APIsIntermediário
daniele-chiappa

Gosidian

daniele-chiappa/gosidian

Vault markdown com MCP server first-class para agentes IA

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP self-hosted que oferece uma camada de automação tipada sobre um vault Obsidian. Combina interface web (Vue 3), sincronização com arquivos `.md` em disco e 48 ferramentas MCP para agentes IA lerem, escreverem e raciocinarem sobre notas estruturadas. Ideal para engenheiros de IA que precisam de memória persistente e estruturada para agentes.

Instalação

$npx convez-ai daniele-chiappa/gosidian

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
3
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 4 dias
Versão
v2.164.1
Issues abertas
6
Contribuidores
2

Casos de uso

  • Memória estruturada e auditável para agentes IA
  • Sistema de planejamento e handoff entre agentes
  • Base de conhecimento com busca full-text e grafos
  • ADRs, skills e audit trails para AI engineering

Veredito

Solução madura para AI engineers que precisam de persistência confiável e estruturada. A escolha de markdown em disco (sem lock-in) e MCP com bearer tokens tipados é sensata; o trade-off deliberado contra RAG/vector search reflete design bem pensado.

README

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

gosidian

Markdown notes your AI agents can read, write, and reason over — via MCP.

A self-contained markdown vault with a built-in MCP server. Humans edit through a web UI, agents talk to it over MCP, everything lives in plain .md files that Obsidian (and every other markdown tool) reads natively.

gosidian in action

Quick start

docker run -d --name gosidian \
  -p 8080:8080 \
  -v "$(pwd)/vault:/vault" \
  ghcr.io/daniele-chiappa/gosidian:latest
# open http://localhost:8080, create admin, copy the MCP token from /admin/tokens
claude mcp add gosidian http://localhost:8080/mcp/sse \
  --transport sse --header "Authorization: Bearer $TOKEN"

Three commands: Docker up → token created from the web UI → agent wired. Your .md vault is persisted under ./vault/; stop the container and the files are still there.

Other installation paths (source, custom compose, bare-metal): docs/getting-started.md.

What is gosidian

  • A markdown vault. Notes are .md files on disk. Open the same folder in Obsidian, VS Code, vim, or any editor you already use. Zero lock-in: delete .gosidian/ and you have a pure Obsidian vault.
  • An MCP server. 48 typed tools let agents bootstrap a session, search, read, write, link, handoff, self-check, audit. Bearer-token authentication with per-project scoping.
  • A web UI. A Vue 3 single-page app served from the same binary (built with Vite, embedded via go:embed). Notes, graph, search and config forms open as windows in a tiling "plancia" workspace — full-text search, backlinks, graph view, editor with live preview, audit trail, admin pages for tokens and users.

All three views hit the same files on disk. The SQLite FTS5 index is a cache — drop it and it rebuilds.

Who it's for

  • AI engineers wiring agents that need persistent structured memory: note-taking, plans, skills, ADRs, handoffs, audit.
  • Obsidian users who want a programmable layer on top of a vault they already trust.
  • Teams with shared vault + per-project scoped tokens per agent.

Why gosidian instead of X

  • vs RAG / vector search: gosidian retrieves by identity (path, tag, frontmatter, backlinks) — more predictable than similarity search for an agent's working memory. Semantic search is deliberately deferred: see ADR-007 rationale.
  • vs Obsidian Sync: Sync mirrors a vault between human devices. gosidian adds a typed automation surface (MCP) to the same vault. Not competitive — complementary.
  • vs Notion / Roam: hosted or proprietary formats; migration is a project. gosidian's vault is already .md files you can take anywhere.

FAQ covers the long form.

Feature highlights

  • Single binary, ≤50 MB, Alpine-based Docker image
  • Web UI: a Vue 3 SPA (Vite, Pinia, Tailwind, CodeMirror, Cytoscape), embedded in the binary — editor + live preview, sidebar, search, graph view, attachments, audit log, admin pages
  • Plancia tiling window manager (niri-style): notes, graph, search and config forms open as resizable, side-by-side windows in a horizontally-scrollable workspace, restorable from the URL
  • MCP server over HTTP + SSE with 48 typed tools
  • Bearer tokens with scopes (read / write) and per-project restriction; cascade-revoke on user disable
  • Multi-user web login with role-based access (owner / member / guest), per-project public/private visibility, and invite-only signup (24h TTL)
  • Optional TOTP two-factor (global mode + per-user override) and LDAP / Active Directory login with guest auto-provisioning
  • Optional git sync (debounced commits, push with token auth)
  • SQLite FTS5 full-text search + ETag optimistic locking
  • Internationalization (IT + EN complete; ES / FR / DE scaffolding)
  • Three theme presets (Midnight Luxury, Light clean, High contrast)
    • custom palette
  • Opinionated Karpathy-Wiki-Stack project layout with one-call scaffolding
  • Optional global projects for skills, agents & scaffold templates shared across projects (opt-in per project, local-overrides-global)

Documentation

AreaStart here
Install + configureGetting started, Configuration, Deployment
MCP integrationOverview, Tool catalogue, Authentication, Client setup, Agent patterns
Web UIOverview, Editor, Authentication & roles, Settings
VaultFormat, Conventions, Multi-project, Global projects, Obsidian compatibility
InternalsArchitecture, Development
Common questionsFAQ

Full index: docs/README.md.

Contributing

Contributions welcome. See CONTRIBUTING.md for the workflow, test expectations, and translation guidelines.

Security

Security issues are reported privately. See SECURITY.md for the disclosure process.

License

Released under the MIT License.

See also

Ver o original no GitHub

Bom para

Relacionados