Docs

Provides a local docs MCP server that exposes Markdown files for AI assistants to search and read.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "reflex-dev-mcp-example": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "/full/path/to/mcp_example/src/mcp_docs_server.py"
      ]
    }
  }
}

You set up a lightweight MCP server to publish your Markdown documentation so AI assistants can search and read it on demand. This makes it easy for tools like Claude to access your docs as a structured, browsable knowledge base, improving answer quality and reducing back-and-forth questions.

How to use

You connect an MCP client to your server and treat your docs as a digital filing cabinet. Once connected, you can ask the AI to list available docs, read a specific document like service-1/user-functions, or search across your entire docs library for terms like authentication or setup.

How to install

Prerequisites you need before installing the MCP server are Python 3.10 or newer and the uv tool for Python package management.

# Install uv if you do not have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install the MCP Python package via uv
uv pip install mcp

Additional notes

To run the server locally with MCP, you use uv to execute the MCP script. You then connect it to Claude Code to enable direct access from the editor and the CLI.

Connecting to Claude Code

From your project folder, add the MCP server using the Claude Code CLI. This links Claude Code to the local server so you can query and read docs directly from the editor.

claude mcp add --transport stdio docs -- uv run python /full/path/to/mcp_example/src/mcp_docs_server.py

Managing the server

Check the current connection status, remove a server, or re-add it as needed to keep your docs accessible to Claude Code.

claude mcp list
claude mcp remove docs
claude mcp add --transport stdio docs -- uv run python /full/path/to/mcp_example/src/mcp_docs_server.py

Connecting to Claude Desktop

To make your documentation available in Claude Desktop, configure the MCP server in Claude Desktop’s settings so it can launch your local server when needed.

Available tools

discoverDocs

Automatically locate Markdown files within the docs directory and prepare them for exposure to MCP-enabled assistants.

exposeDocsViaMCP

Publish discovered Markdown files as MCP resources under docs:// paths for AI tools to access.

searchDocs

Provide search capabilities across all exposed docs so users can find relevant sections quickly.

readDoc

Allow reading the content of a specific documentation resource by its path, such as docs://service-1/user-functions.