MCP Testing Server

🚀 FastAPI 測試服務器

本倉庫提供一個基於 FastAPI 的測試服務器，專門用於 API 開發與測試，能有效提升開發效率和測試準確性。

🚀 快速開始

FastAPI 是一款現代、高性能的 Python 3.7+ 網絡框架，可用於構建帶有標準 Python 類型提示的 API。它既易於上手學習，又具備強大的生產環境應用能力。

先決條件

• Python 3.7+
• pip（Python 包安裝程序）

安裝

# 創建一個虛擬環境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安裝 FastAPI 和 Uvicorn（ASGI 服務器）
pip install fastapi uvicorn

# 可選依賴項
pip install python-multipart  # 用於表單數據
pip install pydantic[email]   # 用於電子郵件驗證

基本示例

創建一個文件 main.py，內容如下：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

運行服務器

uvicorn main:app --reload

服務器將運行在 http://127.0.0.1:8000

✨ 主要特性

• 快速：性能極高，與 NodeJS 和 Go 相媲美
• 直觀：出色的編輯器支持（自動補全）
• 簡單：設計為易於使用和學習
• 簡潔：最大限度減少代碼重複
• 穩健：生成生產就緒的代碼，並帶有交互式文檔
• 基於標準：完全兼容開放標準 API 的開放標準，包括 OpenAPI 和 JSON Schema

📚 詳細文檔

API 文檔

FastAPI 會自動生成交互式 API 文檔：

• Swagger UI：http://127.0.0.1:8000/docs
• ReDoc：http://127.0.0.1:8000/redoc

項目結構

.
├── app/
│   ├── __init__.py
│   ├── main.py          # FastAPI 應用程序
│   ├── dependencies.py  # 依賴項、中間件等
│   ├── routers/         # API 路由模塊
│   ├── models/          # Pydantic 模型
│   ├── schemas/         # 請求/響應模式
│   ├── crud/            # 數據庫 CRUD 操作
│   ├── db/              # 數據庫模型和配置
│   └── core/            # 核心功能
├── tests/               # 測試模塊
├── .env                 # 環境變量
├── .gitignore
├── requirements.txt
└── README.md

部署

FastAPI 應用程序可以部署在多個平臺上：

• Docker
• Heroku
• AWS Lambda
• Google Cloud Run
• Azure Functions
• 傳統的服務器（使用 Gunicorn/Uvicorn）

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

此項目根據 MIT License 分發，詳見 LICENSE 文件。