Polars Docs MCP

一个支持多种传输方式的FastMCP工具，用于搜索和检索Polars API文档。

功能

• 自动发现Polars公共组件（类、函数、子模块）。
• 按组件或查询字符串搜索Polars API。
• 获取当前Polars版本和包信息。
• 返回包含API签名和描述的结构化JSON。
• 支持多种传输方式：STDIO、可流式传输HTTP和SSE。
• 与mcp集成，实现无缝LLM驱动的工作流程。

通过利用Python内置的反射机制，在运行时动态发现Polars中的每个公共类、函数和子模块，从而消除网络爬虫或维护外部文档数据库的成本、脆弱性和维护负担。这种方法保证了每次库发布时100%的实时准确性，无需复杂的文本清洗或嵌入管道，并避免了语义搜索的重型基础设施开销——使其在实时API查找中既简单又高效。

使用方法

1. Claude Desktop 配置（推荐）

{
    "mcpServers": {
        "polarsapifinder": {
            "command": "uv",
            "args": [
                "--directory",
                "/PATH/TO/polars-docs-mcp",
                "run",
                "polarsdocsfinder.py"
            ]
        }
    }
}

2. 手动执行并选择传输选项

STDIO（默认 - 最适合Claude Desktop）

python polarsdocsfinder.py
# 或明确指定：
python polarsdocsfinder.py --transport stdio

可流式传输HTTP（最适合Web部署）

python polarsdocsfinder.py --transport streamable-http
# 带自定义设置：
python polarsdocsfinder.py --transport streamable-http --host 0.0.0.0 --port 8080 --path /api/mcp

SSE（兼容旧客户端）

python polarsdocsfinder.py --transport sse
# 带自定义设置：
python polarsdocsfinder.py --transport sse --host 0.0.0.0 --port 9000

命令行参数

• --transport: 选择传输方式 (stdio, streamable-http, sse) - 默认值: stdio
• --host: HTTP/SSE传输的主机地址 - 默认值: 127.0.0.1
• --port: HTTP/SSE传输的端口号 - 默认值: 8111
• --path: streamable-http传输的URL路径 - 默认值: /mcp

3. MCP服务器的可视化测试

npx @modelcontextprotocol/inspector uv run polarsdocsfinder.py

需要Python 3.11+。

工具端点

• get_polars_version(): 获取当前Polars版本和包信息。
• list_polars_components(): 列出所有高级别的Polars API组件。
• search_polars_docs(api_refs: list[str] | None, query: str | None, max_results: int = 1000): 搜索并检索API签名。
• verify_polars_api(api_ref: str): 验证Polars API引用是否有效。
• list_all_modern_data_stacks(): 列出现代数据堆栈，这些堆栈与Polars兼容。

传输方式

STDIO（默认）

• 最适合: Claude Desktop、本地工具、命令行脚本
• 用法: 直接集成到Claude Desktop配置中
• 通信: 标准输入/输出流

可流式传输HTTP

• 最适合: Web部署、REST API集成、基于浏览器的客户端
• 用法: 运行为HTTP服务，通过HTTP请求连接
• 通信: 向指定端点发送HTTP POST请求

SSE（服务器发送事件）

• 最适合: 兼容现有SSE客户端、实时流传输
• 用法: 集成到遗留系统中
• 通信: 通过HTTP发送服务器发送事件

示例快照

测试HTTP传输

如果使用HTTP传输运行，可以测试服务器：

# 启动服务器
python polarsdocsfinder.py --transport streamable-http --port 8111

# 使用curl测试
curl -X POST http://127.0.0.1:8111/mcp \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/list"}'

许可证

本项目采用MIT许可证。详情见LICENSE文件。

联系方式

由ABC创建。报告问题或请求功能，请访问https://github.com/HotTechStack/polars-docs-mcp/issues。