mongodocs-mcp

🚀 MongoDB Semantic MCP

Lightning-fast semantic search for MongoDB & Voyage AI documentation via Model Context Protocol (MCP).

✨ Features

• 🔍 Semantic Search: Natural language queries across 10,000+ MongoDB documents
• ⚡ Lightning Fast: <500ms search latency with vector embeddings
• 🎨 Beautiful CLI: Professional interface with ASCII art and progress bars
• 🧠 Smart AI: Uses voyage-code-3 for code, voyage-3 for text
• 📊 Comprehensive: 52 documentation sources, 10,392 documents indexed
• 🔄 Hybrid Search: Combines vector + keyword search for best results
• 🎯 MCP Integration: Seamlessly works with Cursor IDE and other MCP clients

📦 Installation

Via NPM (Recommended)

npm install -g mongodocs-mcp

For Cursor IDE

Add to your MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "mongodocs": {
      "command": "npx",
      "args": ["mongodocs-mcp"],
      "env": {
        "MONGODB_URI": "your-mongodb-uri",
        "VOYAGE_API_KEY": "your-voyage-key"
      }
    }
  }
}

🚀 Quick Start

Prerequisites

• Node.js 18+
• MongoDB Atlas cluster (free tier works!)
• Voyage AI API key (Get one here)

1. Install

npm install -g mongodocs-mcp

2. Setup (Interactive Wizard)

mongodocs-setup

The beautiful setup wizard will guide you through:

• 🔗 MongoDB Atlas connection
• 🔑 Voyage AI API key
• 📊 Vector index creation

3. Index Documentation (One-time)

mongodocs-index

Indexes 10,000+ documents from:

• MongoDB Manual (v8.0)
• All major drivers (Node.js, Python, Go, etc.)
• Atlas documentation
• GenAI showcase examples
• Voyage AI documentation

4. Start MCP Server

mongodocs-mcp

5. Configure Cursor IDE

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mongodocs": {
      "command": "npx",
      "args": ["mongodocs-mcp"],
      "env": {
        "MONGODB_URI": "your-mongodb-uri",
        "VOYAGE_API_KEY": "your-voyage-key"
      }
    }
  }
}

🛠️ MCP Tools

search_mongodb_docs

Search MongoDB documentation using natural language.

{
  "query": "how to create compound index",
  "limit": 5,
  "products": ["manual", "nodejs"]
}

explain_mongodb_concept

Get detailed explanations of MongoDB concepts.

{
  "concept": "aggregation pipeline",
  "depth": "intermediate"
}

find_similar_docs

Find documents similar to provided content.

{
  "content": "db.collection.createIndex({field1: 1, field2: -1})",
  "limit": 5
}

get_search_status

Get system status and statistics.

// Returns document count, products indexed, health status

📊 Performance

• Documents: 10,392 indexed
• Search Latency: <500ms average
• Relevance Scores: 0.75-0.89 typical
• Index Size: ~140MB
• Memory Usage: <500MB

🎨 Beautiful CLI

The CLI features:

• ASCII art with gradient colors
• Real-time progress bars
• Animated spinners
• Styled tables
• Interactive prompts

   __  __                        ____  ____  
  |  \/  | ___  _ __   __ _  ___|  _ \| __ ) 
  | |\/| |/ _ \| '_ \ / _` |/ _ \ | | |  _ \ 
  | |  | | (_) | | | | (_| | (_) | |_| | |_) |
  |_|  |_|\___/|_| |_|\__, |\___/|____/|____/ 
                      |___/                    
        🚀 Semantic Search MCP Server

🔧 Configuration

Environment Variables

# Required
MONGODB_URI=mongodb+srv://...
VOYAGE_API_KEY=pa-...

# Optional
MONGODB_DATABASE=mongodb_semantic_docs  # Default
MONGODB_COLLECTION=documents            # Default

MongoDB Atlas Setup

• Create Atlas cluster
• Enable Vector Search
• Create index named vector_index:

{
  "fields": [{
    "type": "vector",
    "path": "embedding",
    "numDimensions": 1024,
    "similarity": "cosine"
  }]
}

📚 Documentation Sources

Tier 1 - Core Documentation

• MongoDB Manual (v8.0)
• MongoDB Atlas Documentation
• MongoDB Shell Documentation

Tier 2 - Language Drivers

• Node.js Driver
• Python (PyMongo & Motor)
• Go Driver
• Java Driver
• Rust Driver

Tier 3 - Specialized

• GenAI Showcase (RAG patterns)
• Voyage AI SDKs
• LangChain MongoDB
• Vector Search Lab

Full list of 52 sources →

🧪 Development

Build from Source

git clone https://github.com/romiluz/mongodocs-mcp.git
cd mongodocs-mcp
npm install
npm run build

Run Tests

npm test

Local Development

npm run dev

🤝 Contributing

Contributions welcome! Please:

• Fork the repository
• Create a feature branch
• Add tests for new features
• Submit a PR

📄 License

MIT © Rom Iluz

🙏 Acknowledgments

• MongoDB for comprehensive documentation
• Voyage AI for powerful embeddings
• Anthropic for Model Context Protocol
• The MCP community

📊 Stats

• Version: 8.0.0
• Downloads:
• Size: ~100KB packed
• Dependencies: 20

Built with ❤️ for the MongoDB community