documentation-search-enhanced 1.0.0

Enhanced MCP server for searching documentation across popular libraries with caching and real-time web search

🚀 Enhanced Documentation Search MCP Server

Transform Claude into your personal development advisor 🤖✨

An intelligent MCP server that gives Claude real-time access to documentation, library popularity data, and career insights. Make smarter technology choices with data-driven recommendations tailored to your experience level.

🔥 NEW: AWS-Style Deployment - No local setup required! Run directly with uvx documentation-search-enhanced@latest just like AWS MCP servers.

---

🎯 AWS-Style Deployment Ready

This MCP server follows the exact same deployment pattern as AWS MCP servers:

# Just like AWS MCP servers - zero setup required!
uvx documentation-search-enhanced@latest

Same professional experience:

• ✅ No local cloning or setup
• ✅ Automatic dependency management
• ✅ Always up-to-date with @latest
• ✅ Works with any MCP-compatible AI assistant

---

⭐ Why This MCP Server is Different

🎯 Intelligent Recommendations - Not just search, but smart suggestions based on your skill level and project needs
📊 Data-Driven Insights - Real popularity scores, job market trends, and learning time estimates
🚀 Career-Focused - Salary insights, trending technologies, and market positioning
⚡ Lightning Fast - Smart caching delivers responses in 2-5 seconds
🔧 AWS-Style Deployment - Same professional deployment model as AWS MCP servers - just run uvx documentation-search-enhanced@latest
🛠️ Universal Compatibility - Works with Cursor, Claude Desktop, Windsurf, and any MCP-compatible tool

🎬 See the Transformation

🤖 Question: "What's the best agentic framework?"

❌ Generic AI Response:

"Popular agentic frameworks include LangChain, AutoGPT, and CrewAI."

✅ Enhanced MCP Server Response:

🎯 LANGCHAIN - Leading Agentic Framework (Score: 92/100)

📊 Real-Time Market Analysis:
• GitHub Stars: 95,247+ ← Live data from GitHub API
• Job Market: EXPLOSIVE (500% increase in Q4 2024)  
• Salary Impact: $50k-$120k+ increase potential
• Companies: Google, Microsoft, OpenAI, Anthropic actively hiring

💡 Career Intelligence:
"LangChain skills can increase salary by $50k-$120k+. 
500% growth in job postings makes it THE #1 AI skill for 2024.
Best time to learn: NOW - market demand far exceeds supply."

🚀 Quick Start (30 seconds)

No local setup required! Run directly with uvx just like AWS MCP servers.

# 1. Install and run directly (no cloning needed)
uvx documentation-search-enhanced@latest

# 2. Get your free API key from serper.dev
export SERPER_API_KEY="your_key_here"

🔧 Add to Your AI Assistant

For Cursor

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "documentation-search-enhanced": {
      "command": "uvx",
      "args": ["documentation-search-enhanced@latest"],
      "env": {
        "SERPER_API_KEY": "your_key_here"
      }
    }
  }
}

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "documentation-search-enhanced": {
      "command": "uvx",
      "args": ["documentation-search-enhanced@latest"],
      "env": {
        "SERPER_API_KEY": "your_key_here"
      }
    }
  }
}

For Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "documentation-search-enhanced": {
      "command": "uvx",
      "args": ["documentation-search-enhanced@latest"],
      "env": {
        "SERPER_API_KEY": "your_key_here"
      }
    }
  }
}

That's it! 🎉 Claude now has intelligent development superpowers.

✨ Benefits of AWS-Style Deployment

✅ Zero Local Setup - No cloning, no path management
✅ Automatic Updates - Always get the latest version with @latest
✅ Isolated Environment - uvx handles dependencies automatically
✅ Universal Compatibility - Works with any MCP-compatible AI assistant
✅ No Maintenance - No local virtual environments to manage

🔄 Update to Latest Version

# The @latest tag automatically gets the newest version
# Just restart your AI assistant to get updates

---

🏠 Local Development (Optional)

If you want to contribute or customize:

# 1. Clone and setup
git clone https://github.com/antonmishel/documentation-search-mcp.git
cd documentation-search-mcp
uv sync

# 2. Get your free API key from serper.dev
echo "SERPER_API_KEY=your_key_here" > .env

# 3. Test the MCP server
python src/documentation_search_enhanced/main.py
# Press Ctrl+C when you see it waiting for input ✅

# 4. Add to Cursor (.cursor/mcp.json):

For local development:

{
  "mcpServers": {
    "documentation-search-enhanced": {
      "command": "/path/to/.local/bin/uv", 
      "args": [
        "--directory",
        "/path/to/documentation-search-mcp",
        "run", 
        "src/documentation_search_enhanced/main.py"
      ],
      "env": {
        "SERPER_API_KEY": "your_key_here"
      }
    }
  }
}

🛠️ 7 Specialized AI Tools

Transform Claude from a generic assistant into a data-driven development expert:

Tool	What It Does	Example Output
🔍 get_docs	Smart documentation search	Returns targeted FastAPI auth docs in 3 seconds
🎯 recommend_libraries	Personalized suggestions with real-time career impact	"FastAPI (91/100): $45k salary boost, 83k+ GitHub stars"
⚖️ compare_libraries	Multi-dimensional analysis with live data	"Winner: Django (91.2/100) vs FastAPI vs Flask (real-time)"
📈 get_trending_libraries	Live trend analysis with growth metrics	"AutoGen: Explosive growth, 500% job increase in Q4"
💡 get_library_insights	Real-time market analysis with ROI data	"React: 236k+ stars, $35k-$85k salary increase, 2-month ROI"
🔤 suggest_libraries	Smart autocomplete with live popularity	"lang" → LangChain (95k+ stars, explosive growth)"
⚡ health_check	Performance tracking of 20+ sources	"20/20 sources healthy, avg 180ms response"

📚 20+ Supported Technologies

🔥 Hot & Trending: FastAPI, LangChain, PromptFlow, AutoGen, OpenAI, Anthropic
⚡ Frontend: React, JavaScript, TypeScript
🛠️ Backend: Django, Flask, Express, Node.js, Python
☁️ Cloud Platforms: AWS, Google Cloud, Azure
🤖 AI Frameworks: LangChain, PromptFlow, AutoGen
🤖 AI Services: OpenAI, Anthropic
🛠️ DevOps: Docker, Kubernetes
📊 Data Science: Pandas, Streamlit

All with real-time GitHub data, job market trends, and career insights!

🌟 Core Intelligence Features

🧠 Real-Time Intelligence (Default)

• Live GitHub Data - Real-time stars, forks, activity, community metrics
• Career Intelligence - Current salary data, job market trends, hiring insights
• Experience Matching - Beginner/Intermediate/Advanced optimization
• Trend Analysis - Live growth velocity and market timing advice

🎯 Personalized Recommendations

• Experience-Level Adaptation - Tailored advice for your skill level
• Use Case Optimization - Web-API, Frontend, AI, Data-Science specific
• Context-Aware Suggestions - Considers project type, timeline, team size
• Future-Proof Guidance - Trend analysis for long-term skill investment

⚖️ Objective Comparisons

• Winner Declarations - Data-driven "best choice" recommendations
• Pros/Cons Analysis - Detailed advantage/disadvantage breakdowns
• Market Position Mapping - Leader/Strong/Moderate/Niche classifications

Prerequisites

• Serper API Key: Get your free key from serper.dev
• UV Package Manager: Install with curl -LsSf https://astral.sh/uv/install.sh | sh

That's it! No Python installation, no virtual environments, no dependency management needed.

Configuration

Adding New Documentation Sources

Adding new libraries is incredibly simple! Just edit the config.json file:

{
    "docs_urls": {
        "your_library": {
            "url": "https://docs.example.com/",
            "category": "web-framework",
            "learning_curve": "easy",
            "tags": ["python", "web", "api"]
        }
    }
}

That's it! The system automatically:

• ✅ Fetches real-time GitHub stars and metrics
• ✅ Calculates popularity scores and job market trends
• ✅ Provides career impact analysis
• ✅ Delivers intelligent recommendations

No manual score updates needed - everything is dynamic!

Usage

Running the Server

# AWS-style deployment (recommended)
uvx documentation-search-enhanced@latest

# Local development (if you've cloned the repo)
python src/documentation_search_enhanced/main.py

Integration with AI Tools

The server integrates seamlessly with any MCP-compatible AI assistant. Simply add the configuration above to your AI tool's MCP settings and restart.

Configuration Files

• Cursor: .cursor/mcp.json (project-specific) or ~/.cursor/mcp.json (global)
• Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Security Best Practices

⚠️ Important: Keep your API keys secure and never commit them to version control. The MCP configuration files should be private and not shared publicly.

Available Tools

1. get_docs - Documentation Search

Search for specific information within library documentation.

Parameters:

• query (string): Your search query
• library (string): The library to search in

Example:

get_docs(query="authentication middleware", library="fastapi")

2. recommend_libraries - Smart Recommendations

Get personalized library suggestions based on your use case and experience level.

Parameters:

• use_case (string): Project type (e.g., "web-api", "frontend", "ai")
• experience_level (string): Your skill level ("beginner", "intermediate", "advanced")

3. compare_libraries - Technology Comparison

Compare multiple libraries with data-driven analysis.

Parameters:

• library_names (list): Libraries to compare

4. Additional Tools

• suggest_libraries - Auto-complete library names
• get_trending_libraries - Find trending technologies
• get_library_insights - Deep analysis of specific libraries
• health_check - Monitor documentation source availability
• clear_cache - Clear cached content

How It Works

1. Query Processing - Takes your search query and target library
2. Real-Time Enhancement - Fetches live GitHub data, job market trends (default)
3. Smart Search - Uses Serper API for site-specific documentation search
4. Parallel Fetching - Concurrently fetches multiple documentation pages
5. Content Extraction - Parses clean text using BeautifulSoup
6. Intelligence Analysis - Applies real-time scoring and career recommendations
7. Intelligent Caching - Stores results for faster future requests

Environment Variables

Create a .env file with:

SERPER_API_KEY=your_serper_api_key_here

Real-Time Intelligence (Default)

The MCP server uses real-time data by default for maximum accuracy:

# Real-time mode is DEFAULT - no setup needed!
# System automatically fetches:
# - Live GitHub stars, forks, activity
# - Current job market trends  
# - Real-time popularity calculations
# - Career impact analysis

# Optional: Add GitHub token for higher API rate limits
export GITHUB_TOKEN=your_github_token

# Switch to static mode only if needed (not recommended)

Benefits of Real-Time Mode:

• ✅ Always current data (never stale)
• ✅ Accurate trending analysis
• ✅ Current job market insights
• ✅ Zero maintenance overhead

Project Structure

documentation-search-mcp/
├── src/
│   └── documentation_search_enhanced/
│       ├── __init__.py           # Package initialization
│       ├── main.py              # Main MCP server implementation
│       └── config.json          # Documentation sources configuration
├── dynamic_enhancer.py          # Optional enhancement module (not used)
├── pyproject.toml              # Project dependencies and packaging
├── publish_to_pypi.sh          # Publishing script for AWS-style deployment
├── test_publish.sh             # Test publishing script
├── README.md                   # This file
├── CONTRIBUTING.md             # Contribution guidelines
├── LICENSE                     # MIT License
└── .env                        # Environment variables (create this for local dev)

Contributing

To add support for new libraries:

1. Add the library and its documentation URL to config.json
2. Test that the documentation site returns useful content
3. Submit a pull request

Troubleshooting

Common Issues

• "Library not supported": Check that the library name matches an entry in config.json
• "No results found": Try a more general search query
• Timeout errors: Some documentation sites may be slow; this is handled gracefully

Integration Issues

• Tool not appearing: Ensure paths are correct and dependencies are installed
• Environment variables: Verify SERPER_API_KEY is set in MCP configuration
• Virtual environment: Use the correct Python path from your venv

🎯 Ready to Transform Your Development Workflow?

⭐ Star this repository if you find it valuable!

🚀 Get Started Now

1. Install: uvx documentation-search-enhanced@latest
2. API Key: Get free key from serper.dev
3. Configure: Add to your AI assistant (see Quick Start above)
4. Experience: Ask Claude "What's the best framework for my project?"

🤝 Join the Community

• 💬 Questions? Open an issue
• 🐛 Bug Reports: We fix them fast!
• ✨ Feature Requests: Your ideas make this better
• 🔀 Pull Requests: Contributions welcome!

---

📜 License

This project is open source under the MIT License. See LICENSE file for details.

---

Made with ❤️ by developers, for developers

Transform Claude into your personal development advisor today!

⭐ Don't forget to star this repo if it helped you! ⭐