Polars Docs MCP

波拉斯文件MCP

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

特性

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

通过利用Python的内置内省功能，在运行时反思性地发现Polars中的每个公共类、函数和子模块，我消除了网络抓取或管理外部文档数据库的成本、脆弱性和维护负担。这种方法保证了每个库版本100%的最新准确性，不需要复杂的文本清理或嵌入管道，并避免了语义搜索的沉重基础设施开销，使其在实时API查找中更简单、更高效。

用法

1.克劳德桌面配置（推荐）

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

2.使用传输选项手动执行

STDIO（默认-最适合克劳德桌面）

python polarsdocsfinder.py
# or explicitly:
python polarsdocsfinder.py --transport stdio

流式HTTP（最适合Web部署）

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（用于传统客户端兼容性）

python polarsdocsfinder.py --transport sse
# With custom settings:
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：可流式传输http的URL路径-默认值： /mcp

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

npx @modelcontextprotocol/inspector uv run polarsdocsfinder.py

MCP INspector

需要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发送事件

快照示例

Claude

Claud2

测试HTTP传输

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

# 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"}'

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

联系

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