🚀 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 文件中指定的条款进行许可。
🔗 参考资料
原文档中未提供具体参考内容。