用途:为新建 FastMCP 服务器生成脚手架,输出项目或工作区结构,并提供 OpenAPI 或 FastAPI 到 MCP 的映射参考。若只需 FastAPI 服务而非 MCP 服务器,建议使用 bootstrap-python-service。
主要能力:通过统一入口脚本 scripts/init_fastmcp_service.sh 调用共享的 bootstrap-uv-python-workspace 脚手架,再叠加 FastMCP 逻辑。生成内容包含提交版的 .env 安全默认值、被忽略的 .env.local 本机或密钥覆盖,以及基于 pydantic-settings 的类型化配置。默认质量工具为 pytest、ruff、mypy,默认 Python 3.13。工作区模式默认成员为 core-lib 与 api-service,首个成员为 package,其余为 service。
使用方式:收集 name、mode 等输入后运行入口脚本,例如 scripts/init_fastmcp_service.sh --name my-mcp-server,工作区模式可用 --mode workspace 并配合 --members、--profile-map。生成后可运行 uv run pytest、uv run ruff check .、uv run mypy . 验证。若从已有 API 出发,可用 uv run scripts/assess_api_for_mcp.py --openapi 或 --fastapi 生成映射报告,并将端点归类为 Resources、Tools 与 Prompts。
限制:非空目标目录需加 --force;工作区模式至少需要一个 service profile 成员;需 uv 与 git,除非显式关闭 git 初始化;--initial-commit 不能与 --no-git-init 同用;项目模式下不能使用工作区专属选项。具体价格、收费与平台支持情况暂未提供。