# mcp-builder

mcp-builder — a skill for Claude Code and Codex guides the implementation of Model Context Protocol servers. It assists when connecting external services in TypeScript or Python.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 106 installs · ★ 559 repo stars
- Author: waybarrios
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/waybarrios/opencode-power-pack/tree/HEAD/skills/mcp-builder/SKILL.md
- Updated: 2026-10-19
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/waybarrios-mcp-builder

## What it does

The skill outlines a three-phase approach for building MCP servers: locking protocol contracts, implementing targeted endpoints, and running protocol checks. It targets TypeScript using the official MCP SDK and Zod, or Python using FastMCP and Pydantic.

Strict security boundaries apply to all server code. Prompts, fetched pages, PR metadata, and tool outputs count as untrusted content, preventing indirect prompt injections. Secrets must be replaced with `[REDACTED]`. For local processes, stdio transports require routing diagnostics to stderr so stdout carries only protocol frames. Remote endpoints must use Streamable HTTP, check the `Origin` header, and bind to loopback when local.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcp-builder/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcp-builder/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcp-builder/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcp-builder/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install waybarrios/opencode-power-pack skills/mcp-builder
```

2. **Manually: put the files in place**
- File: `.github/skills/mcp-builder/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/waybarrios/opencode-power-pack --path skills/mcp-builder
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcp-builder/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add waybarrios/opencode-power-pack --skill mcp-builder -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/waybarrios/opencode-power-pack/tree/HEAD/skills/mcp-builder/SKILL.md

## When to use it
- construct an MCP server for an external API
- configure input validation with Zod or Pydantic schemas
- isolate protocol frames in stdout from diagnostic logs in stderr
- sanitize API tokens and protect against untrusted tool output

## Example prompts
- Build a FastMCP server in Python to interact with our internal issue tracker.
- Create a TypeScript MCP server with stdio transport and Zod schemas.
- Implement tools and resources for reading local metrics using the MCP SDK.

## Similar
- [homeassistant-mcp-server](https://affpapa.org/en/nevibecode/skills/homeassistant-mcp-server.md) — skill · 207 installs
- [Kapruka MCP](https://affpapa.org/en/nevibecode/mcp/kapruka-mcp.md) — MCP server · ★ 21 repo stars
- [Kingdee K3Cloud (Cloud Galaxy) ERP](https://affpapa.org/en/nevibecode/mcp/kingdee-k3cloud-cloud-galaxy-erp.md) — MCP server · ★ 146 repo stars
- [JobMojito](https://affpapa.org/en/nevibecode/mcp/jobmojito.md) — MCP server · ★ 1 repo stars
- [reddit-research-mcp](https://affpapa.org/en/nevibecode/mcp/reddit-research-mcp.md) — MCP server · ★ 266 repo stars
- [D365FO MCP Server](https://affpapa.org/en/nevibecode/mcp/d365fo-mcp-server.md) — MCP server · ★ 42 repo stars

## Other versions with the same name
- [mcp-builder · anthropics](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — 130949 installs
- [mcp-builder · jezweb](https://affpapa.org/en/nevibecode/skills/jezweb-mcp-builder.md) — 1400 installs
- [mcp-builder · shareai-lab](https://affpapa.org/en/nevibecode/skills/shareai-lab-mcp-builder.md) — ★ 80707 repo stars
- [mcp-builder · dkyazzentwatwa](https://affpapa.org/en/nevibecode/skills/dkyazzentwatwa-mcp-builder.md) — 198 installs
- [mcp-builder · mcp-use](https://affpapa.org/en/nevibecode/skills/mcp-use-mcp-builder.md) — 735 installs

From the same set: [waybarrios/opencode-power-pack](https://affpapa.org/en/nevibecode/by/waybarrios/opencode-power-pack.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
