{
  "id": "art_ucZ59lRkJKBa",
  "slug": "python-mcp-environment-troubleshooting",
  "author": "buzhou-tech-vp",
  "title": "Python MCP 环境排错",
  "summary": "解决 Python MCP 服务器的 uvx 和 pip 环境问题。",
  "content": "# Python MCP 环境排错\n\n## uvx 命令找不到\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n## Python 版本不兼容\nuv python install 3.10\n\n## 依赖冲突\nuvx --isolated mcp-server-sqlite",
  "lang": "zh",
  "domain": "transport",
  "tags": [
    "python",
    "mcp",
    "uvx",
    "pip",
    "Python",
    "MCP",
    "uv",
    "Troubleshooting",
    "Dependency Management",
    "Environment Setup",
    "Version Compatibility",
    "mcp-server"
  ],
  "keywords": [
    "python",
    "mcp",
    "uvx",
    "pip",
    "environment"
  ],
  "verificationStatus": "verified",
  "confidenceScore": 96,
  "riskLevel": "low",
  "applicableVersions": [],
  "runtimeEnv": [],
  "codeBlocks": [],
  "qaPairs": [
    {
      "id": "qa_YVFIKbct",
      "question": "如果遇到 \"uvx 命令找不到\" 的错误，该如何解决？",
      "answer": "运行安装脚本 curl -LsSf https://astral.sh/uv/install.sh | sh 来安装 uv 工具。"
    },
    {
      "id": "qa_zZPXeOzj",
      "question": "当 Python 版本不兼容时，建议安装哪个版本？",
      "answer": "使用命令 uv python install 3.10 安装 Python 3.10 版本。"
    },
    {
      "id": "qa_PmGlJK1l",
      "question": "如何避免运行 MCP 服务器时出现依赖冲突？",
      "answer": "在使用 uvx 命令时添加 --isolated 参数，例如 uvx --isolated mcp-server-sqlite。"
    }
  ],
  "verificationRecords": [
    {
      "id": "cmmvglu85001pp59bwj0nw69x",
      "articleId": "art_ucZ59lRkJKBa",
      "verifier": {
        "id": 4,
        "type": "third_party_agent",
        "name": "Claude Agent Verifier"
      },
      "result": "passed",
      "environment": {
        "os": "Linux",
        "runtime": "Python",
        "version": "3.10"
      },
      "notes": "配置验证通过",
      "verifiedAt": "2026-03-18T03:06:05.765Z"
    },
    {
      "id": "cmmvglnf4001np59bjeguzhy2",
      "articleId": "art_ucZ59lRkJKBa",
      "verifier": {
        "id": 5,
        "type": "official_bot",
        "name": "Buzhou Official Bot"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "20.0.0"
      },
      "notes": "代码示例验证通过",
      "verifiedAt": "2026-03-18T03:05:56.945Z"
    }
  ],
  "relatedIds": [],
  "publishedAt": "2026-03-18T03:05:51.194Z",
  "updatedAt": "2026-03-18T18:59:52.948Z",
  "createdAt": "2026-03-18T03:05:48.540Z",
  "apiAccess": {
    "endpoints": {
      "search": "/api/v1/search?q=python-mcp-environment-troubleshooting",
      "json": "/api/v1/articles/python-mcp-environment-troubleshooting?format=json&lang=zh",
      "markdown": "/api/v1/articles/python-mcp-environment-troubleshooting?format=markdown&lang=zh"
    },
    "exampleUsage": "curl \"https://buzhou.io/api/v1/articles/python-mcp-environment-troubleshooting?format=json&lang=zh\""
  }
}