Content
# docs-to-mcp-cli
A CLI tool that generates a self-contained, runnable MCP (Model Context Protocol) server that exposes markdown documentation via specific tools.
## What is MCP?
The [Model Context Protocol (MCP)](https://github.com/model-context-protocol/mcp) is an open standard that enables AI assistants to access external tools and data sources. By converting your documentation to an MCP server, you allow AI assistants to:
- Browse through your documentation
- Search for specific information
- Access the full content of any document
- Use your documentation to provide more accurate and contextual responses
## Installation
You can install the tool globally:
```bash
npm install -g @tiberriver256/docs-to-mcp-cli
```
Or use it directly with npx:
```bash
npx @tiberriver256/docs-to-mcp-cli --docs "path/to/docs/**/*.md" --packageName MyDocsServer
```
## Usage
```bash
docs-to-mcp-cli --docs <pattern> --packageName <n> [--outDir <dir>] [--toolName <name>]
```
### Options
- `-d, --docs <pattern>`: Glob pattern for markdown files (required)
- `-p, --packageName <n>`: Name for the generated MCP server (required)
- `-o, --outDir <dir>`: Output directory for the bundled server (default: "dist")
- `-t, --toolName <name>`: Name of the tool/package/library being documented (used in tool descriptions)
- `-v, --version`: Output the current version
### Examples
```bash
# Generate a server from all markdown files in the docs directory
docs-to-mcp-cli --docs "docs/**/*.md" --packageName ProjectDocs
# Specify a custom tool name and output directory
docs-to-mcp-cli --docs "documentation/**/*.md" --packageName APIDocsServer --toolName "My API" --outDir build
# Run the generated server
node dist/index.js
```
## Generated Server Tools
The generated MCP server provides the following tools to AI assistants:
- `list_docs`: Lists all available documents with a preview of their content
- `get_doc`: Gets the full content of a specific document by its path
- `search_docs`: Searches across all documents using fuzzy matching
## Integration with AI Assistants
Once your MCP server is running, AI assistants that support the Model Context Protocol can connect to it and access your documentation. This enables the AI to provide more accurate and contextual responses based on your specific documentation.
## Development
To build the CLI tool locally:
```bash
# Clone the repository
git clone https://github.com/Tiberriver256/docs-to-mcp-cli.git
cd docs-to-mcp-cli
# Install dependencies
npm install
# Build the project
npm run build
# Link for local development
npm link
```
## Current Version
The current version is 1.1.2. See the [CHANGELOG.md](CHANGELOG.md) for details on recent updates.
Connection Info
You Might Also Like
MarkItDown MCP
Python tool for converting files and office documents to Markdown.
Time
Model Context Protocol Servers
Filesystem
Model Context Protocol Servers
mcp-on-rails
A Rails application template for bootstrapping Rails + MCP applications
mcp-server
MCP server for interaction with Bitwarden.
Fabric-Analytics-MCP
A Model Context Protocol (MCP) server that enables AI assistants to securely...