Python MCP Server Sample

🚀 uv

uvは、Pythonプロジェクトの初期化やMCP SDKの管理、MCPサーバーの構築などを支援するツールです。以下に、uvのインストールからMCPサーバーのClineへの登録までの手順を説明します。

🚀 クイックスタート

📦 インストール

uvをインストールするには、以下のコマンドを実行します。

curl -LsSf https://astral.sh/uv/install.sh | sh

💻 使用例

基本的な使用法

Pythonプロジェクトの作成

以下のコマンドを使用して、mcp-server-demoという名前のPythonプロジェクトを作成します。

# 名前がmcp-server-demoのPythonプロジェクトを作成
uv init mcp-server-demo

MCP SDKのインストール

mcp-server-demoプロジェクトにMCP SDKを追加するには、以下のコマンドを実行します。

# mcp-server-demoプロジェクトディレクトリに移動
cd mcp-server-demo
# mcp-server-demoプロジェクトにMCP SDKを追加
uv add "mcp[cli]"

MCPサーバーの構築

server.pyファイル（ファイル名は任意）を作成し、以下のコードを追加します。

mv main.py server.py

from mcp.server.fastmcp import FastMCP

# デバッグ機能付きのMCPサーバーを作成
mcp = FastMCP("Demo", debug=True)

# 加法ツールを追加
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

# サーバーを起動するためにこの部分のコードを追加
if __name__ == "__main__":
    # stdioトランスポートでサーバーを起動
    print("Starting MCP server in stdio mode")
    mcp.run(transport="stdio")

MCPサーバーのClineへの登録

ClineプロジェクトのMCPファイルを以下のように編集します。

{
  "mcpServers": {
    "mcp-demo-server": {
      "command": "uv",
      "args": [
        "--directory",
        <path to mcp-server-demo>,
        "run",
        "server.py"
      ],
      "alwaysAllow": [
        "add"
      ],
      "disabled": false
    }
  }
}