mcpField
M
mcp-scripts

mcp-scripts

github.com/parcadei开发3.9k494 次安装39 周前更新
代码仓库

关于 mcp-scripts

mcp-scripts 是一项用于编写项目 `scripts/` 目录下脚本的技能，规定面向 Claude 的脚本如何处理命令行参数、MCP 工具调用、错误和输出。

主要功能

  1. 01参数通过命令行传入
  2. 02文件顶部包含用法说明
  3. 03按 runtime 模式调用 MCP 工具
  4. 04提供清晰的错误信息
  5. 05结果输出到标准输出

适用场景

  1. 01编写调用 MCP 工具的脚本
  2. 02避免在源码中硬编码参数
  3. 03使用 runtime harness 检查脚本

MCP 相关

说明通过 `runtime.mcp_client` 使用 `call_mcp_tool("server__tool", params)` 调用 MCP 工具的模式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill mcp-scripts

安装后在 Claude Code 中输入/mcp-scripts确认已加载。

详细介绍

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

评论

支持 Markdown