mcp-documentation

This MCP server powers an AI-assisted documentation and code improvement workflow. It leverages Claude Desktop integration to provide an AI Documentation Guide that maintains and updates a knowledge base, an AI Code Assistant that analyzes and suggests improvements to code, and Brave Search-backed discovery for fast retrieval of relevant documentation. It supports frameworks and languages including React.js, Next.js (with App Router), Python, Vue.js, Angular, and Node.js, making it a flexible tool for developers who want guided documentation, code quality suggestions, and contextual search all in one place. To use it, configure Claude Desktop to point at the server (as shown in the quick-start config) and then issue natural-language commands like “search documentation for Next.js App Router,” “analyze this Python code and suggest improvements,” or “find best practices for React hooks.” The server will respond with AI-generated guidance, code improvement suggestions, and curated documentation results pulled from its knowledge base and Brave-powered search.

Once configured, you can interact with Claude Desktop by asking for targeted tasks such as exploring framework-specific best practices, improving code snippets, or retrieving up-to-date docs on topics like Next.js App Router or async/await in Python. Use the standard Claude prompts you normally employ for search, code review, and guidance, but with the added context of the MCP server’s capabilities for documentation and code assistance.

Prerequisites:

• Node.js and npm installed on your system
• Git (for cloning the repository if you’re developing locally)
• Claude Desktop installed (for integrated usage with this MCP server)

Option A: Quick start using npx (recommended for immediate use)

1. Ensure you have Node.js and npm installed.
2. Install and run the MCP server via npx: npm install -g mcp-documentation-server npx -y mcp-documentation-server
3. Configure Claude Desktop to point to the server as shown in the Quick Start configuration: { "mcpServers": { "documentation": { "command": "npx", "args": ["-y", "mcp-documentation-server"], "env": { "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>" } } } }
4. Start using Claude Desktop with the server integration by issuing natural language commands.

Option B: Local development from repository

1. Clone the repository: git clone https://github.com/mahawi1992/mcp-documentation-server.git cd mcp-documentation-server
2. Install dependencies: npm install
3. Create a .env file (examples below) and fill in required keys: PORT=3000 UPDATE_INTERVAL=3600000 CACHE_DURATION=86400000 BRAVE_API_KEY=your_brave_api_key
4. Start the development server: npm run dev
5. If you prefer the npx approach during development, you can still run the server with: npx -y mcp-documentation-server
6. For Claude Desktop integration, use the config pattern shown in the Quick Start to wire the server with the CLI tool.

Notes and tips:

• BRAVE_API_KEY is required for Brave Search integration. Ensure you obtain a valid key and place it in your environment configuration.
• Environment variables in the config example include BRAVE_API_KEY; you can extend env with additional variables if needed by Claude Desktop or the server.
• If you change ports or cache settings, update the .env file accordingly and restart the server.
• The server supports multiple frameworks/lolders; ensure your Claude prompts reference the correct language or framework to receive the most relevant guidance.
• If using the development workflow, npm run dev typically enables hot-reloading and easier iteration during feature work.
• See the Documentation links in the repo for Usage Guide, Claude Desktop Setup, API docs, and Contributing guidelines for deeper customization and contribution.