Python MCP Documentation Manager

A Model Context Protocol (MCP) server that provides tools for managing documentation files. This server allows AI assistants like Claude to read, list, save, and remove documentation stored in Markdown files.

Features

• list_docs: List all available documentation files
• read_docs: Read the content of one or more documentation files
• save_docs: Save content to a documentation file (with automatic kebab-case naming)
• remove_docs: Delete a documentation file

Installation

Prerequisites

• Python 3.10 or later
• mcp Python package

Setup

1. Clone this repository:

   git clone <repository-url>
   cd python-mcp-docs-manager
   

2. Install dependencies:

   pip install "mcp[cli]"
   

   Or with uv (recommended):

   uv add "mcp[cli]"
   

Usage

Running the Server

You can run the server directly with Python:

python mcp_server.py

Or using the MCP CLI:

mcp run mcp_server.py

Integration with Claude Desktop

1. Create or edit the Claude Desktop configuration file:

   • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration:

   {
     "mcpServers": {
       "docs_manager": {
         "command": "python",
         "args": [
           "/path/to/mcp_server.py"
         ],
         "env": {
           "PYTHONUNBUFFERED": "1"
         }
       }
     }
   }
   

3. Restart Claude Desktop to load the MCP server.

Integration with Cursor IDE

The repository includes an mcp.json file that Cursor IDE can use to connect to the MCP server. No additional configuration is needed.

Documentation Files

All documentation files are stored in the docs/ directory in Markdown (.md) format. Filenames are automatically converted to kebab-case for consistency.

Example Usage (with Claude)

Here are some example prompts you can use with Claude after connecting to this MCP server:

• "List all available documentation files."
• "Read the documentation file named 'mcp-server-guide.md'."
• "Save a new documentation file called 'python best practices' with the following content: [your content here]"
• "Delete the documentation file 'old-guide.md'."

Included Documentation

This repository comes with some pre-made documentation:

• mcp-server-guide.md: A guide on how to create an MCP server in Python
• docker-mcp-server.md: A guide on how to containerize an MCP server with Docker

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.