validasi_mcp 0.1.0-beta.4

MCP server providing Validasi documentation and API reference for AI assistants.

validasi_mcp

MCP server providing Validasi documentation and API reference for AI assistants.

Fetches the Validasi VitePress docs from the hosted site, caches them locally, and exposes them via MCP tools and resources for AI coding assistants.

Tools

Tool	Description
search_docs	Full-text search across all documentation pages
get_page	Retrieve a full documentation page by path (e.g. guide/getting-started)
list_pages	List all available pages, optionally filtered by section
get_code_examples	Retrieve code examples, optionally filtered by rule or page
refresh_docs	Re-fetch all docs from the remote source and rebuild the search index
clean_cache	Delete the local documentation cache

Resources

Every documentation page is exposed as a validasi-docs://{path} resource with text/markdown MIME type.

Usage

# Start the MCP stdio server
dart run bin/validasi_mcp.dart

# Clear the local cache
dart run bin/validasi_mcp.dart --clean-cache

# Force refresh all docs
dart run bin/validasi_mcp.dart --refresh

# Custom cache directory (defaults to ./.validasi_mcp_cache/)
dart run bin/validasi_mcp.dart --cache-dir /path/to/cache

# Point to a local VitePress preview server for development
dart run bin/validasi_mcp.dart --base-url http://localhost:4173/validasi

Configuration

The docs URL defaults to https://albetnov.github.io/validasi and can be overridden via the --base-url CLI flag or DocsConfig.baseUrl in code.

The cache directory defaults to .validasi_mcp_cache/ in the current working directory (project-local). Cache entries are considered fresh for 24 hours.