MCP Hello

🚀 MCP Hello World Server

このプロジェクトは、PythonのFastMCPフレームワークを用いてHTTPトランスポートで構築された、シンプルなHello World MCP (Model Context Protocol) サーバーです。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、インストールと使用方法についても説明します。

✨ 主な機能

• 複数言語での挨拶生成
• サーバーの情報取得
• 簡単なHello Worldメッセージリソースの提供

📦 インストール

前提条件

• Python 3.10 以上

インストール手順

# uvをインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# 仮想環境を作成し、依存関係をインストール
uv sync

# 開発用の依存関係をインストール
uv sync --dev

💻 使用例

サーバーの起動

Dockerを使用する場合 (本番環境)

docker build -t mcp-hello:latest .
docker-compose up -d

uvを使用する場合 (開発環境)

# uvを使ってサーバーを起動 (HTTPポート8000)
uv run python -m mcp_hello.server

# 環境変数を使ってカスタムホスト/ポートを設定
MCP_HOST=localhost MCP_PORT=3000 uv run python -m mcp_hello.server

HTTPサーバーへのアクセス

• デフォルト: http://0.0.0.0:8000
• ローカルアクセス: http://localhost:8000
• カスタム: MCP_HOST と MCP_PORT 環境変数を設定

利用可能なツール

1. say_hello

異なる言語での挨拶を生成します。

パラメータ:

• name (str, オプション): 挨拶する名前 (デフォルト: "World")
• language (str, オプション): 言語コード (デフォルト: "en")

サポートされる言語:

• en - 英語
• es - スペイン語
• fr - フランス語
• de - ドイツ語
• it - イタリア語
• pt - ポルトガル語
• ru - ロシア語
• ja - 日本語
• ko - 韓国語
• zh - 中国語

例:

{
  "tool": "say_hello",
  "arguments": {
    "name": "Alice",
    "language": "es"
  }
}

レスポンス:

{
  "greeting": "¡Hola, Alice!",
  "language": "es",
  "name": "Alice",
  "message": "Greeting generated successfully in es"
}

2. get_server_info

サーバーの機能に関する情報を取得します。

パラメータ: なし

レスポンス:

{
  "name": "Hello World MCP Server",
  "version": "1.2.0",
  "description": "A simple hello world MCP server using FastMCP",
  "capabilities": [
    "greeting generation",
    "multi-language support",
    "server information"
  ],
  "supported_languages": ["en", "es", "fr", "de", "it", "pt", "ru", "ja", "ko", "zh"]
}

利用可能なリソース

1. file://hello-world

簡単なHello Worldメッセージリソースです。

2. file://server-status

現在のサーバーの状態と利用可能なツール/リソースです。

クライアントの使用例

# まず、1つのターミナルでサーバーを起動
uv run python -m mcp_hello.server

# 次に、別のターミナルでHTTPクライアントの例を実行
uv run python mcp_hello/http_client_example.py

環境変数

サーバーは以下の環境変数をサポートしています。

• MCP_HOST: サーバーのホストアドレス (デフォルト: 0.0.0.0)
• MCP_PORT: サーバーのポート番号 (デフォルト: 8000)

例:

MCP_HOST=localhost MCP_PORT=3000 uv run python -m mcp_hello.server

📄 ライセンス

このプロジェクトは、LICENSEファイルに指定された条件でライセンスされています。