mcp-minimal

mcp-minimal

用于验证 MCP 客户端配置是否正常工作的最简 MCP 服务。

版本锁定：需要采取行动

请尽快处理。 此代码库没有完全锁定版本。

缺少的内容：

• 未锁定精确的 Python 版本（仅指定了范围 requires-python = ">=3.10"）。没有 .python-version。
• requirements.txt 中有未锁定的依赖项（1 个）：fastmcp。

为什么这是个问题： 未锁定精确版本时，每次全新安装都会解析为当天可用的最新版本。因此，同一提交在笔记本电脑、Docker 构建和服务器上的表现可能不同，重建也可能在没有任何代码更改的情况下失败。例如：2026-10-21，一次全新安装拉取了 mcp 2.x，并导致多个 MCP 服务故障，因为没有在任何地方锁定 mcp 的版本。开发者的机器也与服务器不同（开发者 PC 运行 Omarchy/Arch、Python 3.14 和 Node 26；dev-playground、hd24devsrv、gptgateway 和 montage 运行 Ubuntu 24.04、Python 3.12；mdm、cma-dev 和 10.24.241.50 运行 Ubuntu 26.04、Python 3.14）。

待办事项：

• 锁定 Python 版本：运行 uv python pin <the target server's version>，并提交 .python-version。
• 锁定依赖项：运行 uv lock 并提交 uv.lock，或者为每个依赖项指定 == 版本（例如 uv pip compile requirements.in -o requirements.txt）。

适用于每个 HD24 代码库的良好实践：

• 提交锁定文件（uv.lock、package-lock.json），并将版本锁定变更视为代码变更：不得静默升级。
• 让锁定的版本与 Docker 基础映像（FROM python:3.12-slim、FROM node:22-slim）及目标服务器保持一致。
• 为每个 Docker 基础映像标记版本，绝不使用 latest。
• 按服务器的实际运行方式在本地测试：使用相同的 Dockerfile/Compose 和本地 .env，而不是原生运行 python app.py。
• 在与目标服务器匹配的 ubuntu:24.04 / ubuntu:26.04 容器中测试主机脚本（apt、systemd、cron）。
• 本地测试是前提，并非证明：最终检查需通过获批的部署流程（pull_build_start_container.sh）在目标服务器上完成。

完成以上所有事项后，删除本节。

pip install -r requirements.txt

关于在 Windows 10 上通过 WSL (2) 使用 Claude Desktop 的详细设置说明：https://janspoerer.github.io/posts/。