🤖 Claude AI Documentation Assistant 📚
A powerful MCP server that supercharges Claude with documentation search capabilities
✨ Features
- 🔍 Smart Documentation Search - Search across multiple AI/ML library documentation
- 🧠 Claude Integration - Seamless connection with Claude's advanced reasoning capabilities
- 🌐 Intelligent Web Search - Leverages Serper API for targeted documentation lookup
- 💨 Fast Response Times - Optimized for quick retrieval and processing
- 🧩 Extendable Architecture - Easily add more documentation sources
📋 Prerequisites
- 🐍 Python 3.8 or higher
- 🔑 Claude Pro subscription
- 🔐 Serper API key (Get one here)
- 💻 Claude Desktop application
🚀 Quick Start
1️⃣ Installation
# Clone the repository
git clone https://github.com/your-username/claude-docs-assistant.git
cd claude-docs-assistant
# Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
2️⃣ Configuration
Create a .env file in the project root with your API keys:
SERPER_API_KEY=your_serper_api_key_here
3️⃣ Start the MCP Server
You should see output indicating the server is running and waiting for Claude to connect.
4️⃣ Connect Claude Desktop App
- 📱 Open the Claude Desktop App
- ⚙️ Click on your profile icon and select "Settings"
- 🧰 Navigate to the "Tools" section
- ➕ Click "Add Tool"
- 🔗 Select "Connect to a local tool"
- 🖥️ Follow the prompts to connect to your running MCP server
- ✅ Confirm the connection is successful
🎮 Using Your Claude Documentation Assistant
Once connected, you can start asking Claude questions that will trigger the documentation search. For example:
Could you explain how to use FAISS with LangChain? Please search the langchain documentation to help me.
Claude will automatically use your MCP server to:
- 🔍 Search for relevant documentation
- 📥 Retrieve the content
- 🧠 Process and explain the information
🔧 Under the Hood
📄 Code Structure
claude-docs-assistant/
├── main.py # MCP server implementation
├── requirements.txt # Project dependencies
├── .env # Environment variables (API keys)
└── README.md # This documentation
🔌 Supported Libraries
The assistant currently supports searching documentation for:
- 🦜 LangChain:
python.langchain.com/docs - 🦙 LlamaIndex:
docs.llamaindex.ai/en/stable - 🧠 OpenAI:
platform.openai.com/docs
🧩 How It Works
- 📡 The MCP server exposes a
get_docs tool to Claude - 🔍 When invoked, the tool searches for documentation using Serper API
- 📚 Results are scraped for their content
- 🔄 Content is returned to Claude for analysis and explanation
🛠️ Advanced Configuration
Adding New Documentation Sources
Extend the docs_urls dictionary in main.py:
docs_urls = {
"langchain": "python.langchain.com/docs",
"llama-index": "docs.llamaindex.ai/en/stable",
"openai": "platform.openai.com/docs",
"huggingface": "huggingface.co/docs", # Add new documentation sources
"tensorflow": "www.tensorflow.org/api_docs",
}
Customizing Search Behavior
Modify the search_web function to adjust the number of results:
payload = json.dumps({"q": query, "num": 5}) # Increase from default 2
🔍 Troubleshooting
Common Issues
- 🚫 "Connection refused" error: Ensure the MCP server is running before connecting Claude
- ⏱️ Timeout errors: Check your internet connection or increase the timeout value
- 🔒 API key issues: Verify your Serper API key is correct in the
.env file
Debugging Tips
Add more detailed logging by modifying the main.py file:
import logging
logging.basicConfig(level=logging.DEBUG)
- ⚡ For faster response times, consider caching frequently accessed documentation
- 🧠 Limit the amount of text returned to Claude to avoid token limitations
- 🌐 Use more specific queries to get more relevant documentation
🤝 Contributing
Contributions are welcome! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feature/amazing-feature) - 💾 Commit your changes (
git commit -m 'Add some amazing feature') - 📤 Push to the branch (
git push origin feature/amazing-feature) - 🔍 Open a Pull Request
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgements
- Anthropic for creating Claude
- Serper.dev for their search API
- All the open-source libraries that make this project possible