pycompat MCP

pycompat_mcp

一个Python MCP服务器，用于解析、审核和查找PyPI包版本，并对目标Python运行时进行完全兼容性检查。作为本地stdio进程或远程HTTP API服务器运行。

实时端点： https://pycompat.duckdns.org/mcp （可用性可能因地区而异）

______________________________________________________________________

快速连接

克劳德代码

claude mcp add --transport http pycompat https://pycompat.duckdns.org/mcp

克劳德桌面

{
  "mcpServers": {
    "pycompat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pycompat.duckdns.org/mcp"]
    }
  }
}

语言链/语言图

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "pycompat": {
        "url": "https://pycompat.duckdns.org/mcp",
        "transport": "streamable_http",
    }
})
tools = await client.get_tools()

OpenAI/LiteLLM

response = litellm.completion(
    model="gpt-4o",
    mcp_servers=[{"url": "https://pycompat.duckdns.org/mcp"}],
    messages=[{"role": "user", "content": "Resolve fastapi and pydantic for Python 3.11"}]
)

健康检查

curl https://pycompat.duckdns.org/health
# → {"status": "ok", "server": "pycompat_mcp"}

______________________________________________________________________

工具（4）

pycompat_resolve

解析包列表和目标Python版本的最新相互兼容版本。

它是如何工作的：

1. 从PyPI获取每个包的实时元数据
2. 按以下方式筛选版本 requires_python 反对 目标 Python（不是主机解释器）
3. 为每个包选择最新的传递版本（贪婪，最新优先）
4. 跑 约束传播 --检测到冲突时，扫描备选候选人以自动修复（最多5轮）
5. 排放a requirements.txt 仅当已解决的集合完全无冲突时才阻止
6. 否则，用可操作的提示抑制该块——建议增加 max_candidates 当冲突使用精确的针时(==)说明符

输入：

输出： Markdown表格+ requirements.txt block+EOL/预发布警告+冲突详细信息

______________________________________________________________________

pycompat_package_info

获取单个PyPI包的完整元数据，可以选择特定版本。

输入：

输出（JSON）：

{
  "name": "numpy",
  "version": "2.4.3",
  "summary": "...",
  "requires_python": ">=3.10",
  "license": "BSD-3-Clause",
  "author": "...",
  "home_page": "...",
  "requires_dist": ["..."],
  "latest_versions": ["2.4.3", "2.4.2", "..."],
  "only_prerelease_versions": false
}

______________________________________________________________________

pycompat_check_pinned

审核一组现有的固定版本的相互兼容性和Python运行时兼容性。

输入：

输出： Markdown表——每包Python OK/fail+任何跨包约束违规

______________________________________________________________________

pycompat_latest_versions

在一次轻量级调用中获取最多50个包的最新稳定版本。

比...更快 pycompat_package_info -每个包同时调用一个API，只返回版本号、发布日期和PyPI链接。

输入：

输出： Markdown表--包/最新稳定/（预发布）/已发布/PyPI链接

______________________________________________________________________

输入验证

______________________________________________________________________

自足执行

运输方式

安装

git clone https://github.com/Adhvyth-T/pycompat_mcp.git
cd pycompat_mcp
pip install -r requirements.txt

在本地运行

标准 ：

python server.py

HTTP：

# Windows (PowerShell)
$env:TRANSPORT="http"; python server.py

# Linux / macOS
TRANSPORT=http python server.py

Docker：

docker compose up --build

连接本地实例

克劳德代码--stdio：

claude mcp add pycompat python "/absolute/path/to/server.py"

克劳德代码——HTTP：

claude mcp add --transport http pycompat http://localhost:8000/mcp

______________________________________________________________________

文件结构

pycompat_mcp/
├── server.py         # Entry point — transport selection, health endpoint, mcp.run()
├── models.py         # Pydantic input models + shared validators (EOL list, version range)
├── pypi.py           # PyPI HTTP client + all metadata helpers
├── resolver.py       # Greedy resolver + constraint propagation loop
├── tools.py          # MCP tool definitions (4 tools)
├── requirements.txt
├── Dockerfile
├── docker-compose.yml
├── .mcp.json         # Claude Code project config (HTTP mode)
└── .gitignore

______________________________________________________________________

已知限制

______________________________________________________________________

维护人员注意事项

Python 3.14发布时： 在 models.py，颠簸 VALID_PYTHON_MINORS["3"] 从 range(0, 14) → range(0, 15). 轨道：https://www.python.org/downloads/

当Python 3.10达到EOL（2026年10月）时： 在 models.py，取消评论 "3.10" 在 EOL_PYTHON_VERSIONS. 轨道：https://devguide.python.org/versions/

______________________________________________________________________

依赖项