A
licenseNot graded
qualityB
maintenanceEnables semantic search over local Markdown documentation using hybrid retrieval combining embeddings, keyword search, and graph traversal with automatic file watching and zero-configuration setup.
2
MIT
Inkdex
by antonlunden
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Inkdex search docs for refresh token expiration"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Inkdex
MCP server for semantic search over markdown docs.
Tools
Tool | Description |
| Search indexed documentation. Returns matching chunks ranked by relevance. |
Related MCP server: QMD - Query Markdown
Usage
Add to your MCP client configuration:
{
"mcpServers": {
"inkdex": {
"command": "npx",
"args": [
"-y",
"inkdex"
],
"env": {
"DOCS_PATH": "/path/to/your/docs"
}
}
}
}Variable | Required | Description |
| Yes | Path to the directory containing markdown files to index |
How it works
Markdown files are split into chunks by heading structure and paragraph boundaries. Chunks are embedded locally using all-MiniLM-L6-v2 and stored in SQLite.
Search ranks results using both vector similarity and BM25 full-text matching, combined via Reciprocal Rank Fusion.
Results include the source, context, and text:
[mira/authentication.md]
<context>
Authentication > Token Expiration and Refresh
</context>
The refresh token expires...Available Tools
1 toolsearch_docsA
Search documentation for relevant information. Returns content that matches the query semantically.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A3.6/5.0
Scored across 1 tool
Disambiguation5/5
Only one tool exists, so there is no possibility of confusion between tools. Its purpose is clear.
Naming Consistency5/5
The single tool name 'search_docs' uses a clear verb_noun structure in snake_case, consistent with common naming conventions.
Tool Count3/5
A single tool is borderline; it may be sufficient for a narrow search-only purpose but feels thin for a broader documentation server.
Completeness3/5
The tool covers semantic search but lacks other potentially useful operations like retrieving a specific document or listing available documentation, which are common in documentation servers.
Maintenance
ActivityInactive
ResponsivenessOutdated data
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Versioned documentation registry and semantic search for AI tools and coding assistants.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Ingest, manage, and retrieve documents for RAG-powered AI applications
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides hybrid search over local markdown knowledge bases using BM25 keyword search and vector semantic search. Enables indexing, querying, and retrieving markdown documentation with dual-mode support for local and remote agents.63,158 npm19MIT
- AlicenseNot gradedqualityCmaintenanceSemantic search over any markdown corpus using local embeddings. Provides tools to search, reindex, and get index stats, with results including file paths, line numbers, and header breadcrumbs.MIT
- AlicenseAqualityDmaintenanceEnables local semantic search over PDF, DOCX, PPTX, and EPUB documents by converting them to Markdown, indexing them in ChromaDB, and retrieving complete structure-aware sections with tables and equations.6MIT