best_engine_ai_helper.mcp module

best-engine-ai-helper: Model Context Protocol (MCP) surface.

A thin adapter that exposes the FastAPI app from best_engine_ai_helper.api as MCP tools, so any MCP-aware host (an agent runtime, an IDE integration, a custom shell) can call /api/system (this machine’s hardware snapshot) and /api/recommend (the best local LLM/VLM engine for a free-text task) as first-class tools — the same detect-then-recommend workflow the CLI’s detect/recommend/report commands expose. Uses fastapi-mcp (https://github.com/tadata-org/fastapi_mcp): one wrapper publishes the whole existing HTTP surface, so the routes are never duplicated.

Run the server (HTTP API + MCP endpoint at /mcp):

best-engine-ai-helper-mcp                 # console entry point
python -m best_engine_ai_helper.mcp       # equivalent

Author

Warith Harchaoui <warith.harchaoui@deraison.ai>

best_engine_ai_helper.mcp.main()[source]

Console entry point (best-engine-ai-helper-mcp): serve the API + MCP endpoint.

Boots the FastAPI app (now serving both the /api/... routes, the /gui page, and the /mcp MCP endpoint) with uvicorn in a single worker. Local-first: binds to loopback by default (override with BEST_ENGINE_HOST / BEST_ENGINE_PORT).

Return type:: None