feat(MCP): add RedisVL MCP CLI

[vishal-bala]

Builds on top of #540

Summary

• The repo did not have an end-to-end MCP entrypoint, which made the MCP design in spec/MCP.md incomplete in practice and left users without a supported way to run RedisVL as an MCP server.
• That gap creates friction for local agent integrations: the server contract, config, filters, and tools existed as design and implementation work, but there was no polished CLI path and no clear packaging/runtime story for using it.
• This change completes the MCP implementation by adding the rvl mcp command, wiring in lazy optional-dependency handling, and rounding out the MCP server/config/tooling surface with tests and documentation updates.
• It also adds task-oriented help text for the new subcommand and keeps the base CLI usable without MCP extras installed.

Testing

• uv run python -m pytest tests/unit/test_cli_mcp.py -q
• uv run python -m pytest tests/unit/test_mcp -q
• uv run rvl
• uv run rvl mcp --help
• Manual smoke check: started uv run rvl mcp --config /tmp/redisvl_mcp_smoke/config.yaml against a live Redis container
• uvx --from 'redisvl[mcp]' rvl mcp --config ... currently resolves the published package, which does not yet include the new extra/CLI path, so that install-path check is not green until a release is cut

---

Note

Medium Risk
Adds a new CLI subcommand that boots and manages an async MCP server lifecycle; failures in argument handling, optional-dependency imports, or async shutdown could impact runtime behavior, but changes are isolated to the CLI path.

Overview
Adds a new rvl mcp CLI subcommand to run RedisVL as an MCP stdio server, including --config and --read-only flags and richer help/usage output.

The MCP entrypoint (redisvl/cli/mcp.py) lazily imports MCP components and optional dependencies, enforces Python >= 3.10, bridges sync CLI to async startup/serve/shutdown, and prints user-facing errors with non-zero exit codes. Unit tests cover dispatch, help output, version/dependency failure modes, and server lifecycle/shutdown behavior.

^{Written by Cursor Bugbot for commit 9441c1d. This will update automatically on new commits. Configure here.}

[jit-ci]

🛡️ Jit Security Scan Results

✅ No security findings were detected in this PR

---

^{Security scan by Jit}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9441c1d942

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".