Construe

Construe

FastMCP server loading Obsidian vault context via frontmatter filtering with chunking.

4
Stars
0
Forks
0
Releases

Overview

mcp-construe is a FastMCP server that loads personal context from Obsidian vaults using YAML frontmatter filtering, enabling AI-friendly management of notes for conversations. It supports bidirectional knowledge management by allowing both reading from and writing to the Obsidian vault, ensuring notes stay synchronized with AI context. To handle long results, it implements smart chunking that splits large result sets into chunks constrained by a 95k character limit, while preserving complete files within each chunk. Filtering is flexible, supporting searches by frontmatter properties and tags with AND/OR logic. A robust File Protection System safeguards file writes: new files and overwrites require a specific frontmatter property value, preventing changes outside designated contexts. Frontmatter generation and parsing are integrated to ensure reliable indexing. The server exposes tools for context loading, matching, frontmatter indexing, and chunk management, plus a file creation function. Configuration is via a config.yaml with vault_path, default_context, and protection settings, and installation steps are provided.

Details

Owner
mattjoyce
Language
Python
License
GNU General Public License v3.0
Updated
2025-12-07

Features

Bidirectional Knowledge Management

Read from and write to your Obsidian vault to keep AI context in sync.

Smart Chunking

Automatically splits large result sets to stay within context limits (95k characters per chunk).

Flexible Filtering

Search by frontmatter properties and tags with AND/OR logic.

File Protection

Secure controls prevent overwriting files outside designated contexts.

Frontmatter Integration

Proper YAML frontmatter generation and parsing for reliable indexing.

Audience

Obsidian usersQuery and manage personal notes context for AI conversations via frontmatter filtering and bidirectional syncing.

Tags

ObsidianfrontmatteryamlMCPknowledge-managementchunkingsecurityvaultcontext-management