Back to Home
kzmshx icon

frontmatter-mcp

by kzmshx

Overview

An MCP server for querying Markdown frontmatter with DuckDB SQL, with optional semantic search capabilities.

Installation

Run Command
uvx frontmatter-mcp

Environment Variables

  • FRONTMATTER_BASE_DIR
  • FRONTMATTER_ENABLE_SEMANTIC
  • FRONTMATTER_EMBEDDING_MODEL
  • FRONTMATTER_CACHE_DIR
  • MCP_TIMEOUT

Security Notes

The server exposes powerful file system and database operations. The `query` tool directly passes user-provided SQL to DuckDB, which is susceptible to SQL injection if the input is not sanitized by the calling client or if the MCP client itself is compromised. Batch file modification tools use `glob` patterns, allowing broad access to files within the `FRONTMATTER_BASE_DIR`, although `_resolve_path` prevents operations outside this directory. Semantic search dependencies download large models from the internet; while configured to a default, an attacker might attempt to manipulate the `FRONTMATTER_EMBEDDING_MODEL` environment variable to load a malicious model.

Similar Servers

Stats

Interest Score0
Security Score5
Cost ClassMedium
Avg Tokens1500
Stars0
Forks0
Last Update2025-12-31

Tags

MarkdownFrontmatterSQLDuckDBSemantic SearchFile ManagementPython