init p2

Author: Kastier1

README.md

@@ -0,0 +1,168 @@
+# MCP Docs Server
+
+A simple way to make your documentation files available to AI assistants like Claude.
+
+## What Does This Do?
+
+Think of this as a **library catalog for your documentation**. You have a bunch of markdown files (`.md` files) with documentation, guides, or notes. This server:
+
+1. Finds all your markdown files automatically
+2. Makes them available to AI tools through something called MCP (Model Context Protocol)
+3. Lets AI assistants search through and read your documentation
+
+It's like giving Claude or other AI tools a filing cabinet of your documentation that they can open and read whenever they need information.
+
+## How It Works (Simple Explanation)
+
+1. **You put documentation files in folders** - Just save your `.md` files in organized folders
+2. **The server finds them automatically** - No need to manually register each file
+3. **AI can read them** - AI assistants can now access and search your documentation
+
+### Real Example
+
+Let's say you have documentation for "Service 1" with these files:
+- `user-functions.md` - How user features work
+- `call-functions.md` - How calling features work
+- `calendar-functions.md` - How calendar features work
+
+You would organize them like this:
+
+```
+docs/
+└── service-1/
+    ├── user-functions.md
+    ├── call-functions.md
+    └── calendar-functions.md
+```
+
+That's it! The server will automatically find these files and make them available as:
+- `docs://service-1/user-functions`
+- `docs://service-1/call-functions`
+- `docs://service-1/calendar-functions`
+
+## Quick Start (Step by Step)
+
+### Step 1: Install Python Requirements
+
+You need Python 3.10 or newer and `uv` (a Python package manager) installed.
+
+Install `uv` if you don't have it:
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Then install the required package:
+
+```bash
+uv pip install mcp
+```
+
+### Step 2: Add Your Documentation Files
+
+Put your markdown files in the `docs/` folder. Organize them in subfolders by topic or service:
+
+```
+docs/
+├── service-1/
+│   ├── user-functions.md
+│   ├── call-functions.md
+│   └── calendar-functions.md
+├── service-2/
+│   └── api-guide.md
+└── getting-started/
+    └── introduction.md
+```
+
+The subfolder name (like `service-1`) becomes the category.
+
+### Step 3: Connect to Claude Code
+
+The easiest way is to use the Claude Code CLI. From this project folder, run:
+
+```bash
+claude mcp add --transport stdio docs -- uv run python /full/path/to/mcp-example/src/mcp_docs_server.py
+```
+
+Replace `/full/path/to/mcp-example` with your actual project path.
+
+Verify it's connected:
+
+```bash
+claude mcp list
+```
+
+You should see: `docs: ... - ✓ Connected`
+
+That's it! Claude Code can now access your documentation.
+
+## Adding New Documentation
+
+To add new documentation at any time:
+
+1. Create a new `.md` file in the appropriate folder under `docs/`
+2. That's it! The server finds new files automatically
+
+For example, to add documentation for a new service:
+
+```
+docs/
+└── service-3/          # Create new folder
+    └── setup.md        # Add your documentation file
+```
+
+No need to restart the server or change any code.
+
+## Using with Claude Code
+
+If you're using Claude Code (the CLI tool), follow Step 3 above. The server is already configured and running!
+
+You can now ask Claude Code questions like:
+- "List all available docs resources"
+- "Read the service-1/user-functions documentation"
+- "Search the docs for authentication"
+
+Claude Code will automatically access your documentation files.
+
+### Managing the Server
+
+Check if the server is connected:
+```bash
+claude mcp list
+```
+
+Remove the server:
+```bash
+claude mcp remove docs
+```
+
+Re-add the server if needed:
+```bash
+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:
+
+1. Find your Claude Desktop config file:
+   - **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+
+2. Open the file and add this (replace `/path/to/mcp-example` with your actual folder path):
+
+```json
+{
+  "mcpServers": {
+    "docs": {
+      "command": "python",
+      "args": ["/path/to/mcp-example/src/mcp_docs_server.py"]
+    }
+  }
+}
+```
+
+## Learn More
+
+- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) - Build your own MCP servers
+- [MCP Documentation](https://modelcontextprotocol.io) - Learn about Model Context Protocol
+- [MCP Python SDK Docs](https://modelcontextprotocol.github.io/python-sdk/) - Complete SDK reference

docs/api/resources.md

@@ -0,0 +1,34 @@
+# Resources
+
+The MCP Docs Server exposes documentation files as resources.
+
+## Resource URI Format
+
+Resources use the following URI format:
+
+```
+docs://{category}/{name}
+```
+
+Where:
+- `category`: The subdirectory name (e.g., "getting-started", "api", "examples")
+- `name`: The filename without the `.md` extension
+
+## Example Resources
+
+- `docs://getting-started/introduction`
+- `docs://getting-started/installation`
+- `docs://api/resources`
+- `docs://api/tools`
+
+## Listing Resources
+
+Use the MCP `resources/list` method to discover all available documentation resources.
+
+## Reading Resources
+
+Use the MCP `resources/read` method with a resource URI to get the markdown content.
+
+## Dynamic Discovery
+
+The server automatically discovers new markdown files when you call `resources/list`. Just add a new `.md` file to the docs directory and it will be available immediately!

docs/api/tools.md

@@ -0,0 +1,40 @@
+# Tools
+
+The MCP Docs Server provides tools for searching and working with documentation.
+
+## search_docs
+
+Search through all documentation files for a given query.
+
+### Parameters
+
+- `query` (string, required): The search term to find in documentation
+- `category` (string, optional): Filter results to a specific category
+
+### Example Usage
+
+```json
+{
+  "query": "installation",
+  "category": "getting-started"
+}
+```
+
+### Returns
+
+A list of matching documents with excerpts showing where the query appears.
+
+### Search Behavior
+
+- Case-insensitive search
+- Searches through entire file content
+- Returns up to 5 matching lines per document
+- Shows line numbers for context
+
+## Future Tools
+
+Planned tools for future versions:
+
+- `get_doc_metadata`: Get metadata about a documentation file
+- `list_categories`: List all available categories
+- `validate_links`: Check for broken internal links

docs/examples/basic-usage.md

@@ -0,0 +1,62 @@
+# Basic Usage Examples
+
+This document provides examples of how to use the MCP Docs Server.
+
+## Example 1: Listing All Documentation
+
+Request all available resources:
+
+```python
+# Using the MCP client
+resources = await client.list_resources()
+
+for resource in resources:
+    print(f"{resource.uri}: {resource.name}")
+```
+
+Output:
+```
+docs://getting-started/introduction: getting-started/introduction
+docs://getting-started/installation: getting-started/installation
+docs://api/resources: api/resources
+docs://api/tools: api/tools
+```
+
+## Example 2: Reading a Document
+
+Read the content of a specific document:
+
+```python
+content = await client.read_resource("docs://getting-started/introduction")
+print(content)
+```
+
+## Example 3: Searching Documentation
+
+Search for specific content:
+
+```python
+results = await client.call_tool(
+    "search_docs",
+    {
+        "query": "installation",
+        "category": "getting-started"
+    }
+)
+
+print(results)
+```
+
+## Example 4: Adding New Documentation
+
+Simply create a new markdown file:
+
+```bash
+# Create a new category
+mkdir -p docs/tutorials
+
+# Add a new document
+echo "# My Tutorial" > docs/tutorials/my-tutorial.md
+```
+
+The server will automatically discover it on the next `list_resources` call!

docs/getting-started/installation.md

@@ -0,0 +1,39 @@
+# Installation
+
+## Prerequisites
+
+- Python 3.10 or higher
+- pip or uv package manager
+
+## Install Dependencies
+
+Using pip:
+
+```bash
+pip install mcp
+```
+
+Using uv:
+
+```bash
+uv pip install mcp
+```
+
+## Running the Server
+
+From the project root:
+
+```bash
+python src/mcp_docs_server.py
+```
+
+Or make it executable:
+
+```bash
+chmod +x src/mcp_docs_server.py
+./src/mcp_docs_server.py
+```
+
+## Configuration
+
+The server automatically looks for markdown files in the `docs/` directory relative to the project root. No additional configuration needed!

docs/getting-started/introduction.md

@@ -0,0 +1,21 @@
+# Introduction
+
+Welcome to the MCP Docs Server documentation!
+
+This server dynamically discovers and serves markdown documentation files as MCP resources.
+
+## Features
+
+- **Dynamic Discovery**: Automatically finds all `.md` files in the docs directory
+- **Categorized Resources**: Organizes documentation by directory structure
+- **Search Capability**: Built-in search tool to find content across all docs
+- **Easy to Extend**: Just add new markdown files to the docs directory
+
+## Getting Started
+
+1. Install the dependencies
+2. Add your markdown files to the `docs/` directory
+3. Run the server
+4. Connect with an MCP client
+
+That's it!

pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "mcp-docs-server"
+version = "0.1.0"
+description = "MCP server that dynamically serves markdown documentation"
+authors = [
+    {name = "Your Name", email = "[email protected]"}
+]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]