Cardea-Agentic-Search 0.10.0

Cardea Agentic Search

A Model Context Protocol (MCP) server that provides agentic search capabilities with support for vector search using Qdrant, keyword search using TiDB, or both combined.

Features

• Vector Search: Semantic search using Qdrant vector database with embedding services
• Keyword Search: Full-text search using TiDB with intelligent keyword extraction
• Combined Search: Use both vector and keyword search simultaneously for comprehensive results
• Flexible Configuration: Choose your search mode via command-line subcommands
• Multiple Transport Types: Support for both SSE and Streamable HTTP MCP transports
• Customizable Keyword Extraction: Configure keyword extraction prompts via environment variables

Major changes

• Introduce new environment variables

  For Vector Search (Qdrant mode):
  - QDRANT_BASE_URL is required
  - QDRANT_COLLECTION is required (can be set via environment or command line)
  - QDRANT_PAYLOAD_FIELD is required (can be set via environment or command line)
  - QDRANT_API_KEY is optional (only needed for authenticated Qdrant instances)
  - EMBEDDING_SERVICE_BASE_URL is required (can be set via environment or command line)
  - EMBEDDING_SERVICE_API_KEY is optional (only needed if embedding service requires authentication)
  - EMBEDDING_SERVICE_MODEL is optional (specify the embedding model name)
  For Keyword Search (TiDB mode):
  - TIDB_CONNECTION is required
  - TIDB_SSL_CA is required (can be set via environment or command line)
  - TIDB_TABLE_NAME is required (can be set via environment or command line)
  - TIDB_SEARCH_FIELD is optional (default: "content")
  - TIDB_RETURN_FIELD is optional (default: "*", supports comma-separated field names)
  - CHAT_SERVICE_BASE_URL is required (can be set via environment or command line)
  - CHAT_SERVICE_API_KEY is optional (only needed if chat service requires authentication)
  - CHAT_SERVICE_MODEL is optional (specify the chat model name)
  For Combined Search mode:
  - QDRANT_BASE_URL, TIDB_CONNECTION are required
  - QDRANT_COLLECTION, QDRANT_PAYLOAD_FIELD are required (can be set via environment or command line)
  - QDRANT_API_KEY is optional
  - TIDB_SSL_CA, TIDB_TABLE_NAME are required (can be set via environment or command line)
  - TIDB_SEARCH_FIELD is optional (default: "content")
  - TIDB_RETURN_FIELD is optional (default: "*", supports comma-separated field names)
  - EMBEDDING_SERVICE_BASE_URL is required (can be set via environment or command line)
  - EMBEDDING_SERVICE_API_KEY is optional
  - EMBEDDING_SERVICE_MODEL is optional (specify model name)
  - CHAT_SERVICE_BASE_URL is required (can be set via environment or command line)
  - CHAT_SERVICE_API_KEY is optional
  - CHAT_SERVICE_MODEL is optional (specify model name)

• Introduce --tidb-return-field CLI option in tidb and search subcommands

  --tidb-return-field <TIDB_RETURN_FIELD>
          Field names to return from TiDB query results, comma-separated (can be overridden by TIDB_RETURN_FIELD env var)