【Claude Code】MCPサーバーを自作して占いツールを作る方法

python --version

コマンドプロンプト画面から上記のコマンドを入力してPythonのバージョンを確認します。

未インストールの場合はPythonを公式サイトからインストールしましょう。

STEP

Python公式サイトにアクセス

まずはサイトにアクセスし、「Downloads」ボタンからWindowsを選択します。

STEP

バージョン「3.10.6」をダウンロード

次に、Pythonバージョン「3.10.6」を選択してダウンロードします。

STEP

Pythonをインストール

インストーラーを開き「Add Python 3.10 to PATH」にチェックを入れて進めます。

仮想環境を起動して有効化します。

python -m venv venv
venv\Scripts\activate.bat

有効化が完了したらプロンプトの先頭に (venv) と表示されます。

pip install fastmcp

そのままコマンドを入力してインストールを開始します。

これで準備完了です。データベースも追加の設定ファイルも不要です。

プロジェクトフォルダに server.py を作り、以下もコードを貼り付けます。

import random
from datetime import date
from fastmcp import FastMCP

# サーバーを作る（"uranai" はツール群の名前）
mcp = FastMCP("uranai")

@mcp.tool
def fortune(name: str, birthday: str = "") -> str:
    """名前（と任意で生年月日）から、今日の運勢を占って返します。"""
    # 名前・生年月日・今日の日付を種にする → 同じ日なら結果は変わらない（日替わり占い）
    seed = f"{name}|{birthday}|{date.today().isoformat()}"
    rng = random.Random(seed)

    levels = ["大吉", "中吉", "小吉", "吉", "末吉", "凶"]
    items = ["読書", "散歩", "コーヒー", "早寝", "新しいアプリ", "掃除"]
    colors = ["赤", "青", "緑", "黄", "白", "紫"]

    return (
        f"【{name}さんの今日の運勢】\n"
        f"運勢: {rng.choice(levels)}\n"
        f"ラッキーアイテム: {rng.choice(items)}\n"
        f"ラッキーカラー: {rng.choice(colors)}\n"
        f"ラッキーナンバー: {rng.randint(1, 49)}"
    )

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

ポイントは3つだけです。

1. FastMCP("uranai") でサーバーの器を作る
2. 占いをする関数に @mcp.tool を付ける（これだけでClaudeから呼べるツールになる）
3. 関数の説明（"""...""" の部分）は、AIが「いつこのツールを使うか」を判断する手がかりになるので、わかりやすく書く

「日付を種（シード）にした乱数」を使っているのがコツです。こうすると同じ人を同じ日に占えば結果は同じ、翌日になれば結果が変わる、という“日替わり占い”らしい挙動になります。

ディレクトリを移動してターミナルで次のコマンドを実行します。

python server.py

エラーが出ずに起動すれば成功です。これでClaude Codeから接続する準備が整いました。

Claude Codeに、サーバーを連携します。

claude mcp add uranai -- python /path/to/server.py

PCにClaude Code（CLI）がまだインストールされていない場合は、下記のコマンドを入力してインストールを済ませます。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

/path/to/server.py は server.py の実際のパスに置き換えてください（仮想環境を使っている場合は、その環境のpythonのパスを指定すると確実です）。

設定後、Claude Codeを開き直すか再読み込みすると、uranai サーバーが認識されます。/mcp コマンドで接続状況を確認できます。

デスクトップアプリと連携する場合は、以下の登録情報をclaude_desktop_config.jsonに入力します。

{
  "mcpServers": {
    "uranai": {
      "command": "C:\\Users\\******\\Documents\\uranai\\venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\*****\\Documents\\uranai\\server.py"]
    }
  }
}

実装が整ったらClaude Codeのアプリを立ち上げて占いをやってみます。

ツールの連係を許可すれば占いが始まります。

決められた内容通りに占いができました。