Agent Skills
返回列表
FastMCP 服务规约编程助手

FastMCP 服务规约编程助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_b785198a/fastmcp-spec。

技能介绍

解决什么问题

FastMCP 服务开发中，MCP 工具、HTTP 路由、OpenAPI 文档、curl 测试、依赖与客户端配置容易散落在不同文件，新增功能时容易漏项，旧项目也难以统一为团队规约。fastmcp-spec 面向基于 FastMcpSvcDemo 模板的项目，把这些约定固化为可执行的编程助手。

技能如何工作

  • 三件套补齐：新增功能时同时维护 src/tools/demo_tools.py 的 @mcp.tool()、src/routers/message_router.py 的 @mcp.custom_route()、src/routers/openapi_router.py 的 OPENAPI_SPEC["paths"]，并创建 tests/test_api_*.sh 测试脚本。
  • 统一响应与文档：区分 MCP 工具、HTTP 路由和错误响应格式，要求函数包含 docstring，包括功能描述、Args: 与 Returns:。
  • 工程约定落地：配置从 conf/config.ini 读取，日志使用 logging.getLogger(__name__)，依赖通过 uv add、uv remove 和 pyproject.toml 管理，执行使用 uv run python。
  • 旧项目改造：按 references/spec_rules.md 中的阶段指南推进，并用检查清单验证。

适用边界

该技能适用于 FastMcpSvcDemo 模板及其衍生项目，尤其适合需要统一新增接口、补齐 OpenAPI 文档或改造旧项目的场景。它不替代具体业务逻辑设计，也不会处理与 FastMCP 服务规约无关的架构决策；使用时需确保项目已有 src/tools/、src/routers/、tests/ 等约定目录。

使用场景

  • 新增 FastMCP 功能时，同步补齐工具、路由、OpenAPI 文档和 curl 测试。
  • 按 uv 与 pyproject.toml 规约添加、移除或更新项目依赖，避免使用 pip 和 requirements.txt。
  • 改造旧 FastMCP 项目时，按阶段指南补齐三件套、日志、配置和检查清单。
  • 确认接口是否符合统一响应、docstring、日志和客户端配置 mcp.json.example 规约。

适合人员

  • 维护 FastMCP 服务模板的后端工程师，需要把新接口按团队规约完整落地。
  • 负责 MCP 接口联调的客户端工程师，需要核对工具、路由和 mcp.json.example 配置。
  • 参与旧服务改造的平台工程师，需要把散乱接口统一到三件套与 uv 依赖规范。
  • 需要审查代码合规性的技术负责人，要检查 docstring、日志、异常和配置读取方式。