技能介绍

解决什么问题

MCP 服务器的价值在于把工具、提示和资源暴露给模型客户端，但真正落地时，认证与可观测性往往是最耗时的环节。多数项目先写出功能原型，再回头补鉴权中间件、请求追踪和结构化日志，结果代码结构被反复改动，重构成本越滚越大。

核心能力与工作方式

Golf 把服务器能力拆成约定目录中的 Python 文件：tools/、prompts/、resources/ 各放一个组件，目录还支持嵌套子目录（例如 tools/payments）来组织更大规模的项目。认证和 OpenTelemetry 钩子作为框架层能力直接提供，开发者无需手写拦截与埋点逻辑。

关键步骤：

确认环境：Python 3.10+、pip、Golf CLI、任意 MCP 兼容客户端
用 CLI 生成项目骨架，得到可预测的目录布局
在 tools/、resources/、prompts/ 下按文件粒度编写组件
启动服务器，客户端即可发现并调用这些能力

适用边界

约定目录意味着项目结构是固定的：组件必须放在 tools/、resources/、prompts/ 之下，否则不会被框架发现。这套方案适合新建项目，或愿意对齐 Golf 约定的团队；已有 Flask/FastAPI 风格代码库想直接迁移的，需要先重写组件组织方式。认证细节与 OTel 配置以官方文档为准。