無料GitHub で公開日本語紹介

mcp-builder

codewhaleで外部ツールを使うためのMCPサーバーを設計・実装し、接続方式や認証を設定して、正常時と異常時の動作確認まで進めるスキル。

原文原文の説明を見る

Design, build, configure, or debug Model Context Protocol servers for codewhale, including stdio and HTTP/SSE transports.

codewhale-hq/Codewhale

インストール方法を見る

こんなときに便利

ローカルツール用MCPサーバーの作成
codewhaleとリモートサービスの接続
認証情報や接続ヘッダーの設定
MCP接続やツールの不具合を調べたいとき

日本語での紹介

できること

AIエージェントと外部ツールをつなぐ仕組みであるMCPのサーバーを、codewhale向けに設計・実装・設定するスキルです。公開するツールの範囲を決め、接続方式と認証情報の扱いを選び、サーバーを登録します。設定の検証とツール一覧の確認に続き、正常なリクエストと失敗するリクエストを試します。

こんなときに便利

手元のツールをエージェントから呼び出したいときや、リモートサービスとの接続を整えたいときに向いています。ツールの入出力定義を整理するほか、外部APIのタイムアウトや分かりやすいエラー処理を含めて設計したい場面にも使えます。

使い方の例

「ローカルのツールを呼び出すMCPサーバーを作り、codewhaleに登録して」
「リモートMCPサーバーの接続設定を確認し、正常時と異常時をテストして」

注意点

codewhaleのMCPコマンドと設定ファイルを使う手順です。ローカル接続にはstdio、リモート接続にはHTTP/SSEを優先します。秘密情報は環境変数で扱い、コミットする設定には含めません。認証や独自の接続先指定に必要なヘッダーは、サーバーごとに設定します。

この紹介文は、公開されている SKILL.md をもとに AI（OpenAI Codex）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（1）

SKILL.md1.5 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

MCP Builder

Use this skill when the user asks to create, configure, or debug an MCP server or tool integration.

Design Rules

Prefer stdio MCP servers for local tools and HTTP/SSE for remote services.
Keep tool schemas small, typed, and explicit. Return structured JSON where possible.
Put secrets in environment variables, never in committed config.
For HTTP/SSE clients, send Accept: application/json, text/event-stream by default unless the server explicitly requires something else.
Add timeouts and clear error messages around external APIs.

Codewhale Setup

Common commands:

codewhale mcp init
codewhale mcp add my-server --command node --arg server.js
codewhale mcp add remote-server --url http://127.0.0.1:3000/mcp
codewhale mcp list
codewhale mcp validate
codewhale mcp tools

HTTP/SSE entries can include per-server headers in ~/.codewhale/mcp.json when credentials or custom routing headers are required.

Workflow

Define the service boundary and the minimum useful tools.
Choose transport and credential handling.
Implement the server using a maintained MCP SDK when available.
Add the server with codewhale mcp add or edit ~/.codewhale/mcp.json.
Run codewhale mcp validate, then codewhale mcp tools.
Test one happy path and one failure path before calling it done.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ