[MCP]ノンプログラマーのためのMCP入門 MCPサーバーを自作しよう！前編

どうも、ケニー（tsujikenzo）です。このシリーズでは、「ノンプログラマーのためのMCP入門」をお届けします。今日は第5回目です。

おさらい
1. なぜuv方式なのか？
2. ローカルMCPサーバーの開発
3. 接続確認
まとめ
1. 参考資料
このシリーズの目次

おさらい

前回は、「MCPサーバーを接続してみよう！」をお届けしました。パターンA：uvx方式を使って、かんたんにMCPサーバーに接続できましたね。

今日は、「自作MCPサーバーの準備をしよう！【前編】」をお届けします。自分のPCにあるMCPサーバーをAIにつなぐ方法、パターンB：uv方式をマスターしましょう。

1. なぜuv方式なのか？

前回使ったuvx方式は、インターネット上に公開されている完成品を、サクッと使うばあいに便利でした。

これから、MCPサーバーを自作するにあたって、

まず、自分のPC上に、MCPサーバー（ファイル）を作成する
追加したい機能などを上書き、保存する
AIホスト（Claude desktop）を再起動して、AIの能力をアップデートしていく
（必要であれば）インターネット上に公開する

というサイクルで、開発していきます。

2. ローカルMCPサーバーの開発

今回は、インターネットには絶対に存在しない、あなたのPCの中にしかないテキストファイルを、AIに読み取らせる体験をしてみましょう。

まず、下準備として、階層構造の【３】と【４】をセットアップします。

ステップ⓪：uvのインストール（Windowsのばあい）

この作業は1度だけでOKです。

ターミナル（PowerShell）を開き、以下のコマンドを実行します。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

インストールが完了したら、ターミナルを再起動しましょう。

uvのバージョンを確認してみます。

uv --version

バージョンが返ってくれば、インストールは成功しています。もしうまくいかないばあいは、PCを再起動してみましょう。

ステップ①：空のプロジェクト（フォルダ）を作成

この作業は、MCPサーバーを作成するごとに行います。

デスクトップに mcp-test-memo というフォルダを作成します。
ターミナル（PowerShell）を立ち上げます。
カレントディレクトリを、先ほど作成したmcp-test-memoフォルダに移動します。

PS C:\Users\Kenzo> cd C:\Users\Kenzo\Desktop\mcp-test-memo
PS C:\Users\Kenzo\Desktop\mcp-test-memo>

プロジェクトの初期化として、このフォルダを定義します。※実行すると、フォルダの中に pyproject.toml という設計図ファイルや、main.pyというサンプルプログラム（雛形）が作成されます。

uv init

開発キット(FastMCP)をインストールします。※実行すると、ネット上から FastMCP というライブラリがダウンロードされ、フォルダの中には uv.lock というファイルや .venv という隠しフォルダが作成されます。

uv add fastmcp

以上です。

これで、第3回で学んだ「実行・インフラ層（階層構造の第3層）」のセットアップが完了しました！

ステップ②：ダミーデータの作成

mcp-test-memoフォルダの中に、my_secretという名前でテキストファイルを作成します。※拡張子は自動で.txtになります。

本文に「私がいま一番食べたいのは、〇〇ラーメンです」 と書いて保存します。

このダミーデータに、AI（Claude desktop）がアクセスできるのか、試してみましょう。

ステップ③：AIに「MCPサーバー」を書かせる

それでは、MCPサーバーの中身を実装します。

中身のプログラムは、生成AIに書かせます。GeminiでもChatGPTでも、なんでも構わないです。

AIへの発注プロンプト例：「PythonのFastMCPを使って、MCPサーバーを作りたいです。同じフォルダにある my_secret.txt というファイルを読み込んで、その中身をテキストで返すだけのシンプルな『ツール（Tool）』を1つ作ってください。ファイル名は app.py とします。コードだけ出力してください。」

テキストファイルを作成しましょう。生成AIが書いてくれたコードをコピーして、フォルダの中に app.py として保存します。

from fastmcp import FastMCP
from pathlib import Path

mcp = FastMCP("secret-reader")

@mcp.tool()
def read_secret() -> str:
    """my_secret.txt の中身を返す"""
    path = Path(__file__).parent / "my_secret.txt"
    return path.read_text(encoding="utf-8")

if __name__ == "__main__":
    mcp.run()

保存するときに、必ずPythonファイルになっていることを確認してください！

ステップ③：構成ファイル（JSON）を「uv方式」で書く

最後に構成ファイルです。claude_desktop_config.json を開き、commandプロパティに、パターンB：uv（ディレクトリ指定）として追加します。

args（引数）には、プロジェクトフォルダの場所や、app.pyをrunするように、指示します。※フォルダの場所は、ご自身の環境に合わせた絶対パスで指定してください。

{
  "mcpServers": {
   "my-secret-tool":{
    "command": "uv",
    "args": [
      "--directory",
      "C:/Users/Kenzo/Desktop/mcp-test-memo",
      "run",
      "app.py"
   ]
  },
  "mcp-server-fetch": {} //前回作成した分
}