MCP Server for AI-OdooFinder - Semantic search for Odoo modules in the OCA ecosystem
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"ai-odoofinder-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# AI-OdooFinder MCP Server **Language**: [English](README.md) | [Español](README.es.md) MCP (Model Context Protocol) server for semantic search of Odoo modules in the OCA ecosystem. ## Overview This MCP server provides a tool called `search_odoo_modules` that enables LLMs to search through 16,494 indexed Odoo modules from OCA repositories using hybrid search (semantic + BM25). ## Quick Start For installation instructions, see the [main project README](../README.md#installation). Basic configuration: ```json { "mcpServers": { "ai-odoofinder": { "command": "uvx", "args": [ "--from", "git+https://github.com/SantipBarber/ai-odoo-finder#subdirectory=mcp-server", "ai-odoofinder-mcp" ], "env": { "AI_ODOOFINDER_API_URL": "https://strategy-orchestrator-prod.tailf7d690.ts.net" } } } } ``` > **Note**: Requires [uv](https://docs.astral.sh/uv/) package manager installed. --- ## Features - **Hybrid Search**: Combines semantic search (embeddings) with BM25 full-text - **Version Filtering**: Only shows compatible modules (Odoo 10.0 to 19.0) - **AI Enrichment**: Descriptions, tags, and keywords generated by Grok-4-fast - **Intelligent Flow**: Smart clarifications, query expansion, confidence levels --- ## Architecture ``` ┌─────────────────┐ │ MCP Client │ (Claude Desktop, Zed, Cursor, etc.) │ (STDIO/HTTP) │ └────────┬────────┘ │ │ JSON-RPC / SSE │ ┌────────▼────────┐ │ MCP Server │ (This component) │ FastMCP + uv │ └────────┬────────┘ │ │ HTTPS │ ┌────────▼────────┐ │ Backend API │ (FastAPI + PostgreSQL) │ :8989 │ └─────────────────┘ ``` **Two modes:** - **STDIO**: For local clients (Claude Desktop) - **HTTP/SSE**: For remote clients (Claude.ai Web, requires port 8080) --- ## Tools ### `search_odoo_modules` Search for Odoo modules using natural language queries. **Parameters:** - `query` (string, required…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.