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 文件中指定的条款进行许可。

🔗 参考资料

原文档中未提供具体参考内容。