MCP脚本规则Skill mcp-scripts

MCP脚本规则技能提供了一套标准实践,用于编写和管理MCP(Model Context Protocol)脚本,包括使用CLI参数处理、工具调用模式、优雅错误处理、结果输出和测试方法,以提高开发效率、代码可维护性和工具互操作性。关键词:MCP脚本、Python脚本、CLI参数、工具集成、自动化、错误处理、测试方法、软件开发最佳实践。

DevOps 0 次安装 0 次浏览 更新于 3/14/2026

名称: mcp-scripts 描述: MCP脚本规则 用户可调用: 否

MCP脚本规则

当处理 scripts/ 目录中的文件时:

  • 对所有参数使用CLI参数(argparse)
  • 在文件顶部包含USAGE文档字符串
  • 使用 call_mcp_tool("server__tool", params) 模式
  • 优雅地处理错误并提供信息性消息
  • 将结果打印到stdout供Claude处理

不要做

  • 在脚本中硬编码参数
  • 编辑脚本来更改参数(改用CLI参数)
  • 直接从servers/导入(使用runtime.mcp_client)

工具命名

工具ID使用双下划线: serverName__toolName

示例:

  • morph__warpgrep_codebase_search
  • ast-grep__ast_grep
  • perplexity__perplexity_ask

测试

测试方法: uv run python -m runtime.harness scripts/<script>.py --help