Agent Skills
› Hmbown/CodeWhale
› mcp-builder
mcp-builder
GitHub用于创建、配置或调试 MCP 服务器及工具集成。涵盖设计原则、传输协议选择、凭证管理及使用 CLI 进行初始化和验证的工作流。
Trigger Scenarios
用户要求创建或配置 MCP 服务器
用户需要调试 MCP 工具集成
Install
npx skills add Hmbown/CodeWhale --skill mcp-builder -g -y
SKILL.md
Frontmatter
{
"name": "mcp-builder",
"description": "Design, build, configure, or debug Model Context Protocol servers for codewhale, including stdio and HTTP\/SSE transports."
}
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-streamby 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 addor edit~/.codewhale/mcp.json. - Run
codewhale mcp validate, thencodewhale mcp tools. - Test one happy path and one failure path before calling it done.
Version History
-
0fe366b
Current 2026-08-16 09:03
将 CLI 命令和配置路径从 deepseek 迁移至 codewhale，更新为当前推荐的工具链。
- b0e4926 2026-07-24 17:42
