mcp-minimal

mcp-minimal

MCP クライアントの設定が機能していることを検証するための最小限の MCP サーバーです。

バージョンの固定：対応が必要です

早めに対応してください。 このリポジトリでは、バージョンが完全には固定されていません。

不足しているもの：

• Python のバージョンが正確に固定されていません（requires-python = ">=3.10" という範囲のみ）。.python-version ファイルがありません。
• requirements.txt の依存関係が固定されていません（1 件）：fastmcp。

これが問題となる理由： 正確なバージョン固定がないと、新規インストールのたびに、その時点で利用可能な最新のバージョンが解決されます。その結果、同じコミットでも、ノート PC、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 は使わないでください。
• ホストスクリプト（apt、systemd、cron）は、対象サーバーと一致する ubuntu:24.04 / ubuntu:26.04 コンテナ内でテストします。
• ローカルテストは必須ですが、それだけでは動作の証明になりません。最終確認は、承認済みのデプロイ手順（pull_build_start_container.sh）を通じて対象サーバーで行います。

上記がすべて完了したら、このセクションを削除してください。

pip install -r requirements.txt

WSL（2）を使用して Windows 10 で Claude Desktop を利用するための詳しいセットアップ手順：https://janspoerer.github.io/posts/。