FastAPI Hello World 应用

一个使用 FastAPI 构建的简单 Hello World API，并支持 MCP SSE。

特性

• 返回 Hello World 消息的根端点
• 接受 name 参数的动态问候端点
• 集成 OpenAI GPT-4o 模型，实现高级 AI 驱动的聊天补全
• 自动生成 Swagger UI API 文档

前提条件

• 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. 创建虚拟环境 (可选但推荐)

# 在 macOS/Linux 上
python -m venv venv
source venv/bin/activate

# 在 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 密钥设置为环境变量：

本地安装

# 将 OpenAI API 密钥设置为环境变量
export OPENAI_API_KEY=your_api_key_here

# 运行应用程序
uvicorn main:app --reload

Docker 安装

# 使用 OpenAI API 密钥运行 Docker 容器
docker run -p 8000:8000 -e OPENAI_API_KEY=your_api_key_here fastapi-hello-world

使用示例

使用 curl

# 获取 Hello World 消息
curl http://127.0.0.1:8000/

# 获取个性化问候语
curl http://127.0.0.1:8000/hello/John

# 获取带有默认提示的 OpenAI 聊天补全
curl http://127.0.0.1:8000/openai

# 获取带有自定义提示的 OpenAI 聊天补全
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 标志运行它，服务器将自动重新加载。