mcpField
M
mcp-scripts

mcp-scripts

github.com/parcadei開発3.9k494 回インストール39 週間前に更新
リポジトリ

mcp-scripts について

mcp-scriptsは、プロジェクトの` scripts/`ディレクトリでスクリプトを書くためのスキルです。Claude向けのスクリプトで、CLI引数、MCPツール呼び出し、エラー処理、出力に関する規則を定めています。

主な機能

  1. 01パラメーターにCLI引数を使用
  2. 02使用方法のdocstringを必須化
  3. 03runtime経由のMCPツール呼び出し
  4. 04適切なエラーメッセージ
  5. 05標準出力への結果表示

活用シーン

  1. 01MCPツールを呼び出すスクリプトの作成
  2. 02パラメーターのソースコードへの直書き防止
  3. 03runtime harnessによるスクリプト検査

MCP 対応

`runtime.mcp_client`を介してMCPツールを呼び出す`call_mcp_tool("server__tool", params)`の形式を説明します。

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/mcp-scriptsを入力して読み込まれたか確認します。

詳細

MCP スクリプトのルール

スクリプト/ 内のファイルを扱う場合：

DO

  • すべてのパラメーターに CLI 引数（argparse）を使用します
  • ファイルの先頭に USAGE docstring を記述します
  • call_mcp_tool("server__tool", params) パターンを使用します
  • 有益なメッセージを表示して、エラーを適切に処理します
  • Claude が処理できるように、結果を stdout に出力します

DON'T

  • スクリプト内にパラメーターをハードコードしません
  • パラメーターを変更するためにスクリプトを編集しません（代わりに CLI 引数を使用します）
  • servers/ から直接インポートしません（代わりに runtime.mcp_client を使用します）

ツールの命名規則

ツール ID ではアンダースコアを 2 つ使用します：serverName__toolName

例：

  • morph__warpgrep_codebase_search
  • ast-grep__ast_grep
  • perplexity__perplexity_ask

テスト

次のコマンドでテストします：uv run python -m runtime.harness scripts/<script>.py --help

コメント

Markdown 対応