MCP Python Tutorial

🚀 MCP Python チュートリアル

このアプリケーションは、簡単なローカルデータベースと模擬データを使用したPythonでのMCPチュートリアルアプリケーションです。

🚀 クイックスタート

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaudeデスクトップ版のPython MCPチュートリアルサーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @jhj0517/mcp-python-tutorial --client claude

手動インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

pip install -r requirements.txt

3. 開発モードでMCPサーバーを起動します。

mcp dev localdb_app.py

4. MCPサーバーのデフォルトポートは5173です。http://localhost:5173にアクセスします。

✨ 主な機能

このチュートリアルアプリケーションは、MCPの核心概念をデモンストレーションしています。
tutorial_app/mcp_server.pyでロールベースの注釈を確認できます。

@mcp.resource

基本的に、この注釈は、REST APIのGETのように、エージェントがリソースを「取得」することに関係しています。

• users://all - すべてのユーザーを取得
• users://{user_id}/profile - ユーザーのプロファイルを取得
• posts://all - すべての投稿を取得
• posts://{post_id} - IDで投稿を取得

@mcp.tool

これは、REST APIのPOSTのように、エージェントが新しいリソースを「生成」することに関係しています。

• create_user - 新しいユーザーを作成
• create_post - 新しい投稿を作成
• search_posts - タイトルまたは内容に基づいて投稿を検索

@mcp.prompt

これは、LLMとの対話を容易にするための再利用可能なテンプレートです。

• user_profile_analysis - ユーザーのプロファイル分析を生成
• post_feedback - 投稿フィードバックの対話型プロンプト

⚠️ 重要提示

詳細な注釈については、こちらをご覧ください：https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#核心概念

クライアントへの接続

MCPサーバーを設定したら、MCPサーバーを使用してエージェントを構築するためにLLMクライアントが必要です。以下のガイドは、Claude Desktopをクライアントとして使用するのに役立ちます。

1. Claude Desktopはuvを使用してMCPサーバーの依存関係をインストールします。まず、uvをインストールします。

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

2. uvを使用してMCPサーバーの依存関係をインストールします。

# 仮想環境を作成してアクティブ化します
uv venv
.venv\Scripts\activate

uv pip install -r requirements.txt

3. Claude Desktopを以下のリンクからダウンロードします。

• リンク

4. claude_desktop_config.jsonファイルを見つけるか作成します。場所はオペレーティングシステムによって異なります。

• Windows:

C:\Users\%USER%\AppData\Roaming\Claude\claude_desktop_config.json

• MacOS/Linux:

~/Library/Application\ Support/Claude/claude_desktop_config.json

5. claude_desktop_config.jsonにmcpServers属性を追加します。

{
    "mcpServers": {
        "local_db": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "localdb_app.py"
            ]
        }
    }
}

注意：複数のMCPサーバーをデプロイすることができ、各サーバーには独自の役割と専門分野があります。
このような関心の分離は、単一のMCPサーバーですべてを実装するよりも優れています。