MCP Server
vault-mcp
robfischer1/vault-mcp
51
InicialPluginScore · de 0 a 100MCP server for Obsidian vault — frontmatter index, graph tools, governance checks, and REST-backed Obsidian API tools
Instalação
$
npx convez-ai robfischer1/vault-mcp1 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
0Forks
0Acompanhando
0Saúde
100%Último commit
há 1 diaVersão
—Issues abertas
48Contribuidores
2README
A tradução para o português deste README ainda está na fila.
vault-mcp
FastMCP server exposing an Obsidian vault as read-only query tools over MCP.
Features
- 4 modules in
src/vault_mcp/layout - MCP server for AI assistant integration
- Quality tooling — pytest, ruff, mypy (strict)
- Python 3.11+
- Apache-2.0 licensed
Quickstart
# Clone and install
git clone https://github.com/robfischer/vault-mcp.git
cd vault-mcp
uv venv && uv pip install -e ".[dev]"
# Run the MCP server
uv run vault-mcp
See docs/fresh-start.md for a complete walkthrough.
Architecture
vault-mcp/
├── src/vault_mcp/
│ ├── index.py # TTL-cached vault index
│ ├── parsers.py # Vault parsing helpers — canonical home
│ ├── rest_client.py # HTTP client for the Obsidian Local REST API
│ └── watcher.py # Filesystem watcher for incremental index invalidation
├── server.py
├── tests/
├── pyproject.toml
See docs/architecture.md for the full design.
MCP Server
See docs/configuration.md for setup instructions.
Development
uv run pytest # 84 tests
uv run ruff check src/ tests/ # lint
uv run mypy src/ # type check
See CONTRIBUTING.md for the full development guide.
Documentation
- Architecture — module map, data flow
- Configuration — settings reference, MCP server setup
- Fresh Start — zero-to-working walkthrough