polars-docs-mcp

# Polars Docs MCP A FastMCP tool to search and retrieve Polars API documentation with support for multiple transport methods. ## Features - Automatically discover Polars public components (classes, functions, submodules). - Search Polars API by component or query string. - Get current Polars version and package information. - Returns structured JSON with API signatures and descriptions. - Support for multiple transport methods: STDIO, Streamable HTTP, and SSE. - Integrates with `mcp` for seamless LLM-powered workflows. > By leveraging Python's built‑in introspection to reflectively discover every public class, function, and submodule in Polars at runtime, I eliminate the cost, fragility, and maintenance burden of web‑scraping or managing an external documentation database. This approach guarantees 100% up‑to‑date accuracy with every library release, requires no complex text cleaning or embedding pipelines, and avoids the heavy infrastructure overhead of semantic search—making it both simpler and far more efficient for real‑time API lookup. ## Usage ### 1. Claude Desktop Config (Recommended) ```json { "mcpServers": { "polarsapifinder": { "command": "uv", "args": [ "--directory", "/PATH/TO/polars-docs-mcp", "run", "polarsdocsfinder.py" ] } } } ``` ### 2. Manual Execution with Transport Options #### STDIO (Default - Best for Claude Desktop) ```bash python polarsdocsfinder.py # or explicitly: python polarsdocsfinder.py --transport stdio ``` #### Streamable HTTP (Best for Web Deployments) ```bash python polarsdocsfinder.py --transport streamable-http # With custom settings: python polarsdocsfinder.py --transport streamable-http --host 0.0.0.0 --port 8080 --path /api/mcp ``` #### SSE (For Legacy Client Compatibility) ```bash python polarsdocsfinder.py --transport sse # With custom settings: python polarsdocsfinder.py --transport sse --host 0.0.0.0 --port 9000 ``` #### Command Line Arguments - `--transport`: Choose transport method (`stdio`, `streamable-http`, `sse`) - Default: `stdio` - `--host`: Host address for HTTP/SSE transports - Default: `127.0.0.1` - `--port`: Port number for HTTP/SSE transports - Default: `8111` - `--path`: URL path for streamable-http transport - Default: `/mcp` ### 3. Visual Testing of MCP Server ```bash npx @modelcontextprotocol/inspector uv run polarsdocsfinder.py ```  Requires Python 3.11+. ## Tool Endpoints - `get_polars_version()`: Get current Polars version and package information. - `list_polars_components()`: List all high-level Polars API components. - `search_polars_docs(api_refs: list[str] | None, query: str | None, max_results: int = 1000)`: Search and retrieve API signatures. - `verify_polars_api(api_ref: str)`: Verify if a Polars API reference is valid. - `list_all_modern_data_stacks()`: List modern data stacks compatible with Polars. ## Transport Methods ### STDIO (Default) - **Best for**: Claude Desktop, local tools, command-line scripts - **Usage**: Direct integration with Claude Desktop configuration - **Communication**: Standard input/output streams ### Streamable HTTP - **Best for**: Web deployments, REST API integration, browser-based clients - **Usage**: Run as HTTP service, connect via HTTP requests - **Communication**: HTTP POST requests to the specified endpoint ### SSE (Server-Sent Events) - **Best for**: Compatibility with existing SSE clients, real-time streaming - **Usage**: Legacy system integration - **Communication**: Server-sent events over HTTP ## Examples Snapshots   ## Testing HTTP Transport If running with HTTP transport, you can test the server: ```bash # Start server python polarsdocsfinder.py --transport streamable-http --port 8111 # Test with curl curl -X POST http://127.0.0.1:8111/mcp \ -H "Content-Type: application/json" \ -d '{"method": "tools/list"}' ``` ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. ## Contact Created by [ABC](mailto:abc@abhishekchoudhary.net). Report issues or request features at https://github.com/HotTechStack/polars-docs-mcp/issues.