MCP Code Guidance

🚀 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