convez.ai
MCP Server
robfischer1

vault-mcp

robfischer1/vault-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for Obsidian vault — frontmatter index, graph tools, governance checks, and REST-backed Obsidian API tools

Instalação

$npx convez-ai robfischer1/vault-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
100%
Último commit
há 1 dia
Versão
—
Issues abertas
48
Contribuidores
2

README

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

License

Apache-2.0

Ver o original no GitHub

Bom para

Relacionados