MCP Python SDKを追加する

プロジェクトのひな形はできましたが、まだMCPと通信できません。次は、面倒な処理をすべて担ってくれる公式ライブラリを取り込みます。📦

公式のPython SDKは、単にmcpという名前のパッケージとして提供されています。通常のPythonでサーバーとクライアントを構築するために必要なものがすべて含まれています。

プロジェクトフォルダー内でuv addを実行し、SDKをインストールして依存関係として記録します。1つのコマンドでSDKが取得され、プロジェクトファイルも更新されます。

[cli]エクストラを追加すると、サーバーの実行や調査に使うコマンドラインツールがインストールされます。これがないとライブラリだけが入り、便利なmcpコマンドは使えません。

名前は必ず「mcp[cli]」のように引用符で囲んでください。多くのシェルでは角括弧が特殊文字として扱われますが、引用符で囲めばそのままの文字として解釈されます。

通常のpipを使いたい場合も、同じパッケージを同じようにインストールできます。どちらのツールでも同一のSDKが得られるので、ワークフローに合う方を選んでください。

uv addはインストールするだけでなく、pyproject.tomlにmcpを書き込みます。プロジェクトをクローンした人も、まったく同じ要件を取得できます。

uvは、解決された正確なバージョンを固定するuv.lockファイルも更新します。これにより、どのマシンでも毎回同じ環境を再現性高くインストールできます。

環境内でSDKをインポートし、インストールが成功したことを確認します。エラーが何も出なければ、mcpパッケージを使う準備は完了です。

最もよく使うクラスはFastMCPで、mcp.server.fastmcpにあります。生のプロトコルの詳細に触れず、ツールを定義できる高水準の方法です。

この1つのインポートで、ツール、リソース、プロンプト用のデコレーターが使えるようになります。SDKによって、通常のPython関数をAIが呼び出せる機能に変えられます。✨

SDK本体とコマンドラインヘルパーが必要です。

mcp[cli]を追加し、pyproject.tomlに記録し、バージョンを固定して、インポートも確認しました。これで実際のMCPサーバーを構築できます。🎯