MCP Hello

🚀 MCP Hello World Server

這是一個簡單的Hello World MCP（模型上下文協議）服務器，使用Python中的FastMCP框架結合HTTP傳輸構建。它可以幫助你快速上手MCP協議的使用，提供多語言問候語生成等功能。

🚀 快速開始

前提條件

• 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（字符串，可選）：要問候的名稱（默認："World"）
• language（字符串，可選）：語言代碼（默認："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

當前服務器狀態和可用工具/資源。

客戶端使用示例

# 首先，在一個終端中啟動服務器
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 文件中指定的條款進行許可。

🔗 參考資料

原文檔中未提供具體參考內容。