Librarian MCP Server
About
Librarian is a Model Context Protocol (MCP) server that provides an API for listing, searching, and retrieving markdown files stored in a structured manner.
Details
- License
- MIT license
Explore
- Structured Document Organization: Documents are organized by section (e.g., daisyui/components/button.md)
- Tag-Based Filtering: Filter documents by tags defined in frontmatter
- Hierarchical Tag Inheritance: Tags are inherited from parent directories
- Flexible Search Capabilities:
- Simple string searches (case insensitive)
- Regular expression searches with customizable flags
- Efficient Document Retrieval: Quickly access specific documents by path
- Tag Discovery: List all available tags with usage counts and optional file paths
- MCP Integration: Seamlessly integrates with the Model Context Protocol
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Librarian MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js (v14 or higher)
- npm or pnpm
pnpm install
LIBRARIAN_DOCS_ROOT=/path/to/your/docs node dist/bin.js
node dist/bin.js
LIBRARIAN_DOCS_ROOT=./my-documentation node dist/bin.js
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"librarian mcp server": {
"mcp-server-librarian": {
"command": "node",
"args": [
"dist/bin.js",
"--docs-root",
"/path/to/your/docs"
]
}
}
}
}McpServers
{
"mcp-server-librarian": {
"command": "node",
"args": [
"dist/bin.js",
"--docs-root",
"/path/to/your/docs"
]
}
}<div align="center">
<h3>Knowledge at your fingertips</h3>
</div>
Overview
Librarian is a Model Context Protocol (MCP) server that provides an API for listing, searching, and retrieving markdown files stored in a structured manner. It serves as a knowledge base for Large Language Models (LLMs), providing them with the information they need on demand.
Librarian does not provide any writing operations - it is a read-only service designed to efficiently deliver document content to LLMs through the MCP framework.
Features
- Structured Document Organization: Documents are organized by section (e.g., daisyui/components/button.md)
- Tag-Based Filtering: Filter documents by tags defined in frontmatter
- Hierarchical Tag Inheritance: Tags are inherited from parent directories
- Flexible Search Capabilities:
- Simple string searches (case insensitive)
- Regular expression searches with customizable flags
- Efficient Document Retrieval: Quickly access specific documents by path
- Tag Discovery: List all available tags with usage counts and optional file paths
- MCP Integration: Seamlessly integrates with the Model Context Protocol
Project Structure
The Librarian MCP server is organized into modular components:
- src/lib/config.ts: Type definitions and loader for configuration
- src/lib/load.ts: Document loading and processing functionality
- src/lib/librarian.ts: Core librarian implementation with schemas
- src/lib/util.ts: Formatting utilities for plaintext responses
- src/lib/server.ts: MCP server implementation
- src/bin.ts: CLI entry point
- src/index.ts: Library entry point
This modular design allows for easy extension and maintenance, with clear separation of concerns.
Installation
Prerequisites
- Node.js (v14 or higher)
- npm or pnpm
Installation Steps
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
