FastAPI Hello World Application

FastAPI Hello World 应用

使用 FastAPI 并支持 MCP SSE 的简单 Hello World API。

功能

• 根端点，返回 Hello World 消息
• 动态问候端点，接受姓名参数
• 集成 OpenAI 和 GPT-4o，提供由 AI 驱动的高级聊天补全功能
• 自动生成 API 文档，并提供 Swagger UI

前提条件

• Python 3.7+（用于本地设置）
• pip（Python 包安装程序）
• OpenAI API 密钥（用于 /openai 端点）
• Docker（可选，用于容器化设置）

设置说明

你可以在本地运行此应用，也可以使用 Docker 运行。

本地设置

1. 克隆代码库

git clone https://github.com/xxradar/mcp-test-repo.git
cd mcp-test-repo

2. 创建虚拟环境（可选，但建议创建）

# On macOS/Linux
python -m venv venv
source venv/bin/activate

# On Windows
python -m venv venv
venv\Scripts\activate

3. 安装依赖项

pip install -r requirements.txt

4. 运行应用

uvicorn main:app --reload

应用将启动，并可通过 http://127.0.0.1:8000 访问。

或者，你也可以直接使用 Python 运行应用：

python main.py

Docker 设置

1. 克隆代码库

git clone https://github.com/xxradar/mcp-test-repo.git
cd mcp-test-repo

2. 构建 Docker 镜像

docker build -t fastapi-hello-world .

3. 运行 Docker 容器

docker run -p 8000:8000 fastapi-hello-world

应用可通过 http://localhost:8000 访问。

API 端点

• GET /：返回简单的 Hello World 消息
• GET /hello/{name}：返回包含所提供姓名的个性化问候
• GET /openai：返回 OpenAI 的 GPT-4o 模型生成的回复（接受可选的 prompt 查询参数）
• GET /docs：Swagger UI 文档
• GET /redoc：ReDoc 文档

OpenAI 集成

/openai 端点使用 OpenAI 的 GPT-4o 模型，需要将 OpenAI API 密钥设置为环境变量：

本地设置

# Set the OpenAI API key as an environment variable
export OPENAI_API_KEY=your_api_key_here

# Run the application
uvicorn main:app --reload

Docker 设置

# Run the Docker container with the OpenAI API key
docker run -p 8000:8000 -e OPENAI_API_KEY=your_api_key_here fastapi-hello-world

使用示例

使用 curl

# Get Hello World message
curl http://127.0.0.1:8000/

# Get personalized greeting
curl http://127.0.0.1:8000/hello/John

# Get OpenAI chat completion with default prompt
curl http://127.0.0.1:8000/openai

# Get OpenAI chat completion with custom prompt
curl "http://127.0.0.1:8000/openai?prompt=Tell%20me%20a%20joke%20about%20programming"

使用 MCP

连接到 MCP Inspector

npx @modelcontextprotocol/inspector

使用 Web 浏览器

• 在浏览器中打开 http://127.0.0.1:8000/，查看 Hello World 消息
• 在浏览器中打开 http://127.0.0.1:8000/hello/John，查看个性化问候
• 在浏览器中打开 http://127.0.0.1:8000/openai，使用默认提示词获取 OpenAI 的回复
• 在浏览器中打开 http://127.0.0.1:8000/openai?prompt=What%20is%20FastAPI?，获取关于 FastAPI 的回复
• 打开 http://127.0.0.1:8000/docs，查看 Swagger UI 文档

开发

如需修改应用，请编辑 main.py 文件。如果使用 --reload 标志运行服务器，服务器将在修改后自动重新加载。