用途:按既定模式快速创建可被 Claude Code 等客户端集成的 MCP 服务器,保证一致性、可靠性与可维护性。
主要能力:给出标准目录结构(server.py、requirements.txt、测试、README、config.example.env);提供基于 mcp 库的异步 Python 服务端模板,含 Server 初始化、工具注册(@self.server.tool())、stdio 传输入口;统一错误处理为 JSON(成功 {"status":"success",...},失败 {"status":"error","error":"..."});结构化日志与日志级别;通过环境变量配置并在 _validate_config() 校验;提供 pytest 测试模板、README 与 MCP 配置片段;附 HTTP API 客户端、数据库连接、TTL 缓存等常见集成模式。
用法:前提是 pip install mcp>=1.0.0。创建 mcp/servers/{server-name}/ 目录,按模板实现 server.py 与依赖,编写测试并运行 pytest test_{name}.py -v 或快速测试 python test_{name}.py,然后在 .claude.json 的 mcpServers 中以 command=python、args 指向 server.py、env 传变量方式注册。
适用场景:需要为 Claude Code 等 MCP 客户端新增自定义工具或外部服务集成时作为脚手架与规范参考。
限制:资料未提供具体版本兼容范围、性能指标、收费或授权信息;需自行实现工具实际业务逻辑并自行验证。