yu9824/mcp-tutorial

3.2

If you are the rightful owner of mcp-tutorial and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This project demonstrates a simple implementation of a Model Context Protocol (MCP) server using the FastMCP framework, incorporating tools, resources, and prompts.

Tools

1

Resources

0

Prompts

0

MCP Tutorial

このプロジェクトは、Model Context Protocol (MCP) を使用したシンプルなデモンストレーションです。FastMCPフレームワークを使用して、ツール、リソース、プロンプトを含むMCPサーバーを実装しています。

機能

ツール (Tools)

役割: アクションを実行し、処理や計算を行う
例: 2つの数値を足し算する add 関数
使い道: 計算処理、データ変換、外部API呼び出し、ファイル操作など

リソース (Resources)

役割: 動的なデータやコンテンツを提供する
例: 個人化された挨拶メッセージを生成する greeting://{name} リソース
使い道: データベースアクセス、ファイル読み取り、設定情報取得、APIデータ取得など

プロンプト (Prompts)

役割: AIモデル向けの指示やテンプレートを生成する
例: 様々なスタイルの挨拶プロンプトを生成する greet_user プロンプト
使い道: チャットボットの応答生成、文書作成支援、翻訳、要約などのAIタスク

セットアップ

1. 環境の作成

conda create -yn mcp312 python=3.12 --file ./requirements.txt

2. 環境のアクティベート

conda activate mcp312

使用方法

サーバーの起動

# 直接実行
python3 server.py

# または、serve.shスクリプトを使用
./serve.sh

クライアントの実行

python3 client.py

クライアントを実行すると、以下のテストが自動的に実行されます：

利用可能なツールの一覧表示
add ツールの実行テスト（5 + 3 = 8）
利用可能なリソースの一覧表示
greeting://Alice リソースの読み取りテスト
利用可能なプロンプトの一覧表示
greet_user プロンプトの実行テスト

ファイル構成

server.py: MCPサーバーの実装（FastMCPフレームワーク使用）
client.py: MCPクライアントの実装とテスト
serve.sh: サーバー起動用のシェルスクリプト
requirements.txt: Python依存関係
LICENSE: ライセンスファイル

技術スタック

Python 3.12
FastMCP: MCPサーバー実装のためのフレームワーク
MCP (Model Context Protocol): AIモデルとツール間の通信プロトコル

ライセンス

このプロジェクトのライセンス情報については、LICENSE ファイルを参照してください。