サーバーのプロジェクト構成
サーバーを簡単に拡張できるよう、ファイルを整理します。
「サーバーのプロジェクト構成」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
構成が土台を作る
小さなサーバーなら1つのファイルに収まりますが、適切な構成にしておけば、混乱せずに拡張できます。今少し計画しておくと、後で大きな苦労を避けられます。🗂️
まずは1つのファイルから
ほとんどのサーバーは、最初は1つのserver.pyから始まります。そこにFastMCPのインスタンスと1つか2つのツールを置けば、動かし始めるには十分です。
pyproject.tomlが地図になる
ルートにはpyproject.tomlを置き、プロジェクト名と依存関係を宣言します。uvはこれを読み取り、何をインストールすべきか正確に判断します。
ロックファイルを維持する
その隣にはuv.lockがあり、解決済みのすべてのバージョンを固定して記録します。チームメンバーがまったく同じ環境を再現できるよう、コミットしてください。
.venvをGitの対象外にする
.venvフォルダーはソースコードではなく自動生成されるものです。.gitignoreに追加し、サイズが大きくマシン固有の環境をコミットしないようにしてください。
.venv/
__pycache__/プリミティブごとに分ける
規模が大きくなったら、役割ごとにコードを分割します。tools、リソース、プロンプトを別々のモジュールに分けると、各ファイルの役割が明確になり、読みやすくなります。
典型的なツリー構成
成長したサーバーは、多くの場合次のような構成になります。サーバーのエントリーポイントと、機能の種類ごとのフォルダーを並べます。明確なフォルダー構成なら、すばやく目的の場所へ移動できます。🌳
my-server/
server.py
tools/
resources/
prompts/1つのエントリーポイント
FastMCPのインスタンスを作成し、すべてを登録するエントリーポイントを1つに保ちます。クライアントが起動する必要があるのは、この1つのファイルだけです。
インラインではなくインポートする
ツールは専用のモジュールで定義し、エントリーファイルでインポートして登録します。こうすればserver.pyを短く保ち、内容をすばやく確認できます。
from tools.math import register_math
register_math(mcp)READMEを追加する
インストール方法とサーバーの実行方法を説明する短いREADMEがあれば、他の人と共有しやすくなります。将来の自分も、今の自分に感謝するでしょう。
秘密情報は外部に置く
キーをコードにハードコードしてはいけません。環境変数から読み取り、サンプルの.envを用意して、設定の安全性と移植性を保ちましょう。🔐
クイックチェック
バージョン管理に何をコミットするか決めようとしています。
拡張できる構成
最初は1つのファイルから始め、pyproject.tomlとロックファイルを追跡対象にし、.venvを無視して、プリミティブごとに分割する方法を学びました。これでサーバーをきれいに拡張できます。✅
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「サーバーのプロジェクト構成」レッスンは無料ですか？
はい。「サーバーのプロジェクト構成」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「サーバーのプロジェクト構成」で何を学びますか？
サーバーを簡単に拡張できるよう、ファイルを整理します。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。
「サーバーのプロジェクト構成」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- Pythonとuvをインストールする
- MCP Python SDKを追加する
- mcp CLIを使う
- サーバーのプロジェクト構成