# mcp-transport-guide

The mcp-transport-guide skill guides you through choosing and building MCP transport layers, covering stdio for local processes plus SSE and streaming HTTP for remote services.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 492 repo stars
- Author: aiskillstore
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aiskillstore/marketplace/tree/HEAD/skills/emillindfors/mcp-transport-guide/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcp-transport-guide

## What it does

The skill provides reference architectures and Rust implementation patterns for Model Context Protocol transports. It breaks down three main mechanisms: process-level `stdio`, event streams over `SSE`, and HTTP streaming endpoints built with `axum`.

A critical detail is logging discipline on `stdio`. Because the server exchanges JSON-RPC packets directly over standard output, printing debug text to `stdout` corrupts the protocol. The guide enforces routing all diagnostics to `stderr`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill mcp-transport-guide -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill mcp-transport-guide -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill mcp-transport-guide -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aiskillstore/marketplace skills/emillindfors/mcp-transport-guide
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill mcp-transport-guide -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aiskillstore/marketplace --path skills/emillindfors/mcp-transport-guide
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill mcp-transport-guide -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/aiskillstore/marketplace/tree/HEAD/skills/emillindfors/mcp-transport-guide/SKILL.md

## When to use it
- pick the right MCP transport for local execution or cloud hosting
- configure process `stdio` communication without corrupting JSON-RPC data
- implement an `axum` HTTP streaming server for remote agent access
- secure an MCP endpoint using Bearer token authorization middleware

## Example prompts
- Compare stdio versus SSE transport for my MCP server
- Show an Axum HTTP transport implementation with Bearer token auth
- How do I structure Rust logging so it does not break stdio transport?

## Similar
- [omni-mcp](https://affpapa.org/en/nevibecode/skills/omni-mcp.md) — skill · 1400 installs
- [domain-web](https://affpapa.org/en/nevibecode/skills/domain-web.md) — skill · 3500 installs
- [axum-web-framework](https://affpapa.org/en/nevibecode/skills/axum-web-framework.md) — skill · 666 installs
- [axum](https://affpapa.org/en/nevibecode/skills/axum.md) — skill · 508 installs
- [rust-project](https://affpapa.org/en/nevibecode/commands/rust-project.md) — command · ★ 42780 repo stars
- [rust](https://affpapa.org/en/nevibecode/skills/oakoss-rust.md) — skill · 128 installs

From the same set: [aiskillstore/marketplace](https://affpapa.org/en/nevibecode/by/aiskillstore/marketplace.md) — 18 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
