MCP Server Tutorial

MCP サーバーのチュートリアル

このリポジトリには、FastMCP で構築されたシンプルな MCP（Model Context Protocol）サーバーが含まれています。このサーバーは、MCP プロトコルを通じて利用できる、さまざまな数学演算をツールとして提供します。

特長

• 基本的な算術演算（加算、減算、乗算、除算）
• 高度な数学関数：
  • べき乗
  • 平方根
  • 立方根
  • 階乗
  • 対数
  • 三角関数（sin、cos、tan）
  • 余り
• 動的なあいさつリソース

前提条件

• Python 3.8 以降
• FastMCP ライブラリ

インストール

1. このリポジトリをクローンします
2. 仮想環境を作成して有効化します：

   uv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. 依存関係をインストールします：

   uv install fastmcp
   

使用方法

サーバーの実行

次のコマンドでサーバーを実行します：

python main.py

サーバーはデフォルトで SSE（Server-Sent Events）トランスポートを使用するため、MCP Inspector を使って接続できます。

MCP Inspector を使った接続

1. MCP Inspector を開きます

npx @modelcontextprotocol/inspector

3. SSE トランスポートタイプを選択します
4. サーバーの URL（通常は http://localhost:8000/sse）に接続します
5. サーバーで定義されている数学ツールとリソースを操作できるようになります

利用可能なツール

• add(a, b)：2つの数値を加算します
• subtract(a, b)：2つの数値を減算します
• multiply(a, b)：2つの数値を乗算します
• divide(a, b)：2つの数値を除算します
• power(a, b)：a の b 乗を計算します
• sqrt(a)：数値の平方根を計算します
• cbrt(a)：数値の立方根を計算します
• factorial(a)：数値の階乗を計算します
• log(a)：数値の自然対数を計算します
• remainder(a, b)：a を b で割ったときの余りを計算します
• sin(a)：数値の正弦を計算します
• cos(a)：数値の余弦を計算します
• tan(a)：数値の正接を計算します

利用可能なリソース

• greeting://{name}：指定された名前に合わせたあいさつを返します

サーバーの変更

main.py のパターンに従って、ツールやリソースを追加できます：

1. 新しいツールを追加するには、@mcp.tool() デコレーターを使います
2. 新しいリソースを追加するには、@mcp.resource() デコレーターを使います

トランスポートのオプション

FastMCP は、次の2つのトランスポートプロトコルをサポートしています：

• stdio：標準入出力（ターミナルベース）
• sse：Server-Sent Events（ブラウザベース、MCP Inspector と互換性があります）

トランスポートプロトコルを変更するには、mcp.run() 呼び出しの transport パラメーターを変更します。