语义文档搜索服务器

python server.py

python server.py --transport http --port 8505

docker-compose up -d

# Clone and navigate
cd docsplorer

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your API_URL and API_KEY

# Run in stdio mode (IDE)
python server.py

# Run in HTTP mode (n8n)
python server.py --transport http --port 8505

# Quick start
docker-compose up -d

# Access at: http://localhost:8505

Trigger → MCP Client → Process → Output

# API Configuration
API_URL=http://localhost:8001
API_KEY=your-api-key-here

# Qdrant Settings
QDRANT_COLLECTION=content

# Search Defaults
DEFAULT_LIMIT=1
DEFAULT_CONTEXT_WINDOW=5

# Transport Selection
TRANSPORT=http  # or stdio
HOST=0.0.0.0
PORT=8505

{
  "mcpServers": {
    "docsplorer": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {
        "API_URL": "http://localhost:8001"
      }
    }
  }
}

{
  "tool": "search_filenames_fuzzy",
  "arguments": {
    "query": "release notes",
    "limit": 10
  }
}

# MCP HTTP endpoint tests
python -m tests.test_http_mode

# Direct functional tool tests
python -m tests.test_functional

# API key / authentication tests
python -m tests.test_mcp_tools

# Final verification of tool registration
python -m tests.final_verification

# Basic health check for HTTP mode
curl http://localhost:8505/

docker pull cryptogi/docsplorer:latest
docker run -p 8505:8505 cryptogi/docsplorer:latest

npm install -g docsplorer-mcp