MCP Pythonチュートリアル

モックデータを備えたシンプルなローカル DB を使用した Python の MCP チュートリアル アプリ

インストールと実行

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Python MCP チュートリアル サーバーを自動的にインストールするには:

手動インストール

1. このリポジトリをクローンする

2. 依存関係をインストールします:

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

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

MCPの機能

このチュートリアルアプリは、MCPのコアコンセプトを実証します。tutorial_app /mcp_server.pyでロールごとのアノテーションを確認できます。

@mcp.resource

基本的に、このアノテーションは、RESTAPI のGETと同様に、エージェントがリソースを「取得」することに関するものです。

• users://all - すべてのユーザーを取得

• users://{user_id}/profile - ユーザーのプロフィールを取得する

• posts://all - すべての投稿を取得する

• posts://{post_id} - IDで投稿を取得する

@mcp.tool

これは、RESTAPI のPOSTと同様に、エージェントが新しいリソースを「生成」することです。

• create_user - 新しいユーザーを作成する

• create_post - 新しい投稿を作成する

• search_posts - タイトルまたは内容で投稿を検索

@mcp.prompt

これは、LLM と便利にやりとりするための再利用可能なテンプレートです。

• user_profile_analysis - ユーザーのプロフィールの分析を生成する

• post_feedback - 投稿のフィードバックのための対話型プロンプト

クライアントに接続中

MCPサーバーをセットアップしたら、MCPサーバーを使用してエージェントを構築するLLMクライアントが必要です。以下のガイドは、 Claude Desktopをクライアントとして接続する方法を説明します。

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

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

3. Claude Desktop のダウンロードはこちら:

• https://claude.ai/download

4. claude_desktop_config.jsonファイルを見つけるか作成します。場所は OS によって異なります。

• ウィンドウズ:

• MacOS/Linux:

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

注: 複数のMCPサーバーを導入し、それぞれに専用の関心と専門知識を持たせることもできます。関心を分離することは、すべてを単一のMCPサーバーに実装するよりも効果的です。

6. Claude Desktop を再起動します。