Show HN: OpenAI Apps Handbook
4 months ago
- #chatGPT
- #FastAPI
- #MCP
- 前提条件包括：Python 3.10+、基本了解Python数据类、FastAPI/异步Python、HTTP/REST概念和HTML。
- MCP服务器应用有三个核心组件：小部件（widgets）、响应ChatGPT请求的功能函数，以及FastAPI + Uvicorn服务。
- 小部件需要HTML模板、元数据和唯一的模板URI。
- 功能函数包括：list_tools()、list_resources()、call_tool_request()和read_resource()。
- FastAPI提供GET /mcp用于SSE流，POST /mcp/messages用于后续消息。
- 分步指南：创建项目目录、虚拟环境并安装依赖项。
- main.py的基本结构包括定义小部件数据结构和初始化FastMCP。
- 添加小部件涉及在列表中定义它们并构建查找字典。
- 使用Pydantic模型处理输入验证。
- 工具元数据包括OpenAI特定的渲染提示。
- 注册list_tools、list_resources和call_tool_request的处理程序。
- 测试服务器包括本地运行和使用MCP Inspector等工具。
- 部署注意事项包括环境变量、Docker和生产环境设置（使用gunicorn）。
- 常见模式包括身份验证、速率限制、数据库集成和缓存。
- 故障排除提示涵盖服务器检查、小部件验证、输入模式和CORS问题。