MCP Code Guidance

Pythonを使用してMCPとA2Aプロトコルを学ぶチュートリアルプロジェクトで、複数のMCPサービスサンプルと開発チュートリアルが含まれています。

教育と学習ツール開発者ツール #プロトコル学習 #エージェント相互作用 #Pythonチュートリアル .Python

スコア : 2ポイント

ダウンロード数 : 5

更新時間 : 2025-04-28

MCPコードガイダンスとは？

これは、実際のコード例を通じて、MCP（モデル - コンテキストプロトコル）とA2A（エージェント間プロトコル）のプロトコルを実装する方法を示す教育プロジェクトです。MCPプロトコルは、AIモデルが外部環境と相互作用することを可能にし、A2Aプロトコルはエージェント間の協調をサポートします。

MCPコードガイダンスの使い方は？

プロジェクトでは、最も単純なツール統合から実際の天気/株価照会サービスまで、段階的に深くなる複数のサンプルサーバーを提供しています。ユーザーはサンプルコードを実行することで、プロトコルの実装を学ぶことができます。

適用シーン

AIエージェントと外部システムの相互作用機能を開発したい開発者、または複数のAIエージェントの協調を実装する必要があるシーンに適しています。

主要機能

多プロトコルサポートMCP（モデル環境相互作用）とA2A（エージェント協調）の2つのプロトコルを同時にサポートします。

段階的学習簡単なものから複雑なものまでの複数のサンプルプロジェクトを通じて、段階的にプロトコルの実装を習得できます。

多環境サポートテキスト、画像、音声などのさまざまな外部環境との相互作用をサポートします。

利点と制限

利点

学習しやすい明確なコード構造とコメント

実際に実行可能なサンプルプロジェクトを提供

基本的な使用シーンから高度な使用シーンまで網羅

制限

現在はPythonでの実装のみをサポート

基本的なPython開発知識が必要

一部の高度な機能は自分で拡張する必要がある

使い方

uvツールをインストールする

まず、Python環境を管理するためにuvツールをインストールする必要があります。

プロジェクトを初期化する

サンプルプロジェクトディレクトリを選択して移動し、初期化を行います。

仮想環境を作成する

プロジェクトに独立したPython仮想環境を作成します。

依存関係をインストールする

プロジェクトに必要なPython依存パッケージをインストールします。

サーバーファイルを作成する

サンプルに基づいてサーバー実装ファイルを作成します。

使用例

基本サービスをすばやく起動する最も単純なMCPサービスを実装し、基本的なツール相互作用機能のみを含みます。

天気照会サービスMCPプロトコルを通じて天気を照会できるサービスを実装します。

株価照会サービスMCPプロトコルを通じて株価情報を照会できるサービスを実装します。

よくある質問

uvツールをインストールする際にネットワーク接続が失敗した場合はどうすればいいですか？

どのバージョンのPythonが必要ですか？

自分のツールをMCPサービスに追加するにはどうすればいいですか？

🚀 MCP - コードガイダンス

mcp-code-guidanceは、Python言語を使用してMCPとA2Aプロトコルをゼロから学ぶためのチュートリアルです。MCP（Model-Context Protocol）とA2A（Agent-to-Agent）は、大規模モデルアプリケーションにおける2つの重要なプロトコルで、それぞれエージェントと外部ツールの相互作用、およびエージェント間の協調に重点を置いています。

MCPプロトコルは、モデルと外部環境との相互作用に使用されるプロトコルで、APIを介してモデルが外部環境と通信し、外部環境の情報を取得できるようにします。MCPプロトコルの主な特徴は以下の通りです。

テキスト、画像、音声など、さまざまな外部環境をサポートします。
大規模モデル、小規模モデルなど、さまざまなモデルをサポートします。

https://modelcontextprotocol.io/introduction

📁 プロジェクト構造

mcp-code-guidance/
├── LICENSE
├── README.en.md
├── README.md
├── mcp-server-01quickstart # 最もシンプルなMCPサービス、ツールのみ含む
├── mcp-server-02weather # 天気を照会するMCPサービス
├── mcp-server-03stock # 株価を照会するMCPサービス
├── my-project
└── tutorial # MCPとA2Aの開発チュートリアル

🛠️ 環境要件

Python 3.10+

📦 インストールガイド

1. uvのインストール

uvのインストールコマンド

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

install.shスクリプトを実行すると、github.comからuv-aarch64-apple-darwin.tar.gzがダウンロードされ、解凍されてインストールされます。github.comのネットワークが不安定な場合は、手動でダウンロードすることができます。ここでは、ローカルのPython HTTP一時サービスを起動してファイルのダウンロードをサポートし、install.shスクリプト内のダウンロードアドレスをローカルサービスのアドレスに変更するテクニックを提供します。

python -m http.server 8181

調整後のshellスクリプトはこちらを参考にできます: 修正後のuv-install.sh

ユーザーのローカルbinディレクトリをPATHに追加

vi ~/.bash_profile
export PATH="$HOME/.local/bin:$PATH"
source ~/.bash_profile

2. プロジェクトの初期化（mcp-server-01quickstartを例とする）

# 新しいプロジェクトディレクトリを作成
uv init  mcp-server-01quickstart -p3.11 
cd mcp-server-01quickstart

# 仮想環境を作成してアクティブ化する
uv venv
source .venv/bin/activate

# 依存関係をインストールする
uv add "mcp[cli]" httpx

# サービスファイルを作成する
touch mcp-server-01quickstart.py