Docs To MCP Cli

🚀 Convert Docs to MCP CLI Tool

A command-line tool that generates a self-contained and runnable MCP (Model Context Protocol) server, which exposes markup language documents through specific tools.

🚀 Quick Start

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to access external tools and data sources. By converting your documents into an MCP server, you can enable AI assistants to:

• Browse documents
• Search for specific information
• Access the full-text content of any document
• Use your documents to provide more accurate and context-based responses

📦 Installation

You can install the tool globally:

npm install -g @tiberriver256/docs-to-mcp-cli

Or use it directly with npx:

npx @tiberriver256/docs-to-mcp-cli --docs "path/to/docs/**/*.md" --packageName MyDocsServer

💻 Usage Examples

Basic Usage

docs-to-mcp-cli --docs <pattern> --packageName <n> [--outDir <dir>] [--toolName <name>]

Options

• -d, --docs <pattern>: Wildcard pattern for markup language files (Required)
• -p, --packageName <n>: Name of the generated MCP server (Required)
• -o, --outDir <dir>: Output directory for packaging the server (Default: "dist")
• -t, --toolName <name>: Name of the tool, package, or library documented (for tool description)
• -v, --version: Display the current version

Advanced Usage

# Generate a server from all markup language files in the document 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

📚 Documentation

Generated Server Tools

The generated MCP server provides the following tools for AI assistants:

• list_docs: List all available documents and display content previews
• get_doc: Get the full-text content of a specific document by path
• search_docs: Search 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 documents. This enables AI to provide more accurate and context-based responses based on your specific documents.

🔧 Technical Details

Development

To build the CLI tool locally:

# 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

📄 License

Current Version

The current version is 1.1.2. Check CHANGELOG.md for detailed information on recent updates.