A Model Context Protocol (MCP) server providing coordinate conversion tools and document search with Qdrant vector database, featuring quadrant-based spatial search and filtering.

🚀 Features

• Document Storage: Store and retrieve document chunks with optional geolocation
• Quadrant-Based Search: Search within specific geographic quadrants (NE, NW, SE, SW)
• Location-Based Search: Find documents near specific coordinates
• Hybrid Search: Combine semantic search with geospatial filtering
• Fast Vector Search: Powered by Qdrant's efficient vector similarity search

🚀 Quick Start with UV

1. Install UV (if not already installed)

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or with pip
pip install uv

2. Setup the Project

# Navigate to your project directory
cd MCP_ADDRESS

# Create a virtual environment and install dependencies
uv venv
uv pip install -e .

3. Run the MCP Server

# Activate the virtual environment (optional, uv can run without activation)
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Run
python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload

The server will start on http://127.0.0.1:8000/sse/

To run the MCP inspector

npx @modelcontextprotocol/inspector http://127.0.0.1:8000/sse/

🔧 Configure Claude Desktop

Add this to your Claude Desktop config file:

Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "quadrant": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/MCP_ADDRESS",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

Replace /absolute/path/to/MCP_QUADRANT with your actual project path.

📦 Available Tools

Coordinate Conversion

1. tlc_to_address_tool - Convert TLC codes to addresses
2. address_to_tlc_tool - Convert addresses to TLC codes
3. address_to_plasma_tool - Convert addresses to Plasma format
4. plasma_to_address_tool - Convert Plasma coordinates to addresses

Document Search & Storage

5. store_document_chunks - Store document chunks with optional geolocation
6. search_documents_by_quadrant - Search within a specific geographic quadrant
7. search_documents_near_location - Search near specific coordinates
8. search_documents_by_filename - Search documents by filename