Add documentation search tool for AI-powered doc discovery

[mattpodwysocki]

Summary

Implements search_mapbox_docs_tool following the Google Developer Knowledge API approach for enhanced documentation discovery.

Changes

New Tool: search_mapbox_docs_tool

Features:

• 🔍 Search Mapbox documentation for specific topics
• 📊 Returns ranked, relevant sections (not entire corpus)
• 🏷️ Filter by category (apis, sdks, guides, examples)
• ⚙️ Configurable result limit (1-20, default 5)
• ⚡ 1-hour caching for performance
• 🎯 Relevance scoring and ranking algorithm
• 📝 Context-aware excerpt extraction

Input:

{
  "query": "geocoding rate limits",
  "category": "apis",  // optional
  "limit": 5  // optional, default 5
}

Output:

{
  "results": [
    {
      "title": "Forward Geocoding",
      "excerpt": "...Rate limit: 600 requests per minute...",
      "category": "apis",
      "url": "https://docs.mapbox.com/...",
      "relevanceScore": 0.95
    }
  ],
  "query": "geocoding rate limits",
  "totalResults": 3,
  "category": "apis"
}

Implementation Details

• Fetches and parses docs.mapbox.com/llms.txt
• Categorizes sections automatically
• Calculates relevance scores based on query match
• Returns structured output with excerpts and URLs
• In-memory caching with 1-hour TTL

Testing

✅ Comprehensive test suite with 12 tests:

• Basic search functionality
• Category filtering
• Relevance ranking
• Caching behavior
• Error handling
• Edge cases

✅ All 548 tests passing

Related

Closes #68

Part of enhanced documentation discovery initiative inspired by:

• https://developers.googleblog.com/introducing-the-developer-knowledge-api-and-mcp-server/

Next Steps

This is the first of 5 planned improvements:

• Add Documentation Search Tool for AI-powered doc discovery #68 - Documentation Search Tool (this PR)
• Split monolithic documentation resource into logical sections #69 - Split Documentation Resources
• Add contextual documentation retrieval tool #70 - Contextual Documentation Tool
• Add API Endpoint Explorer tool for structured API information #71 - API Endpoint Explorer
• Add live code examples tool for working snippets #72 - Live Examples Tool