Neo Combat Workshop — MCP Servers + Claude Code Skills

"I know kung fu." — Neo

This repo contains three MCP servers and a Claude Code Skill for a hands-on workshop on creating Skills that leverage MCP tools.

Project Structure

neo-skills-mcp-workshop/
├── neo-kungfu-mcp/         # Punches & kicks (short-range combat)
├── neo-firearms-mcp/       # Guns & bullet dodging
├── neo-sword-mcp/          # Bladed weapon combat
├── skill/
│   └── SKILL.md            # The Neo combat skill (this is what we build in the workshop)
└── README.md

MCP Servers Overview

| Server | Tools | When to use | |--------|-------|-------------| | kungfu | defend_against_kick, defend_against_punch, attack_with_punch, attack_with_kick | Short-range hand-to-hand combat | | firearms | dodge_bullet, fire_gun | Gun fights and bullet dodging | | sword | block_sword_attack, attack_with_sword | Sword and blade combat |

Each tool returns a text art scene of Neo performing the action plus a combat log message.

Setup

1. Add MCP servers to Claude Code

No cloning or installing required — uvx handles everything automatically:

claude mcp add neo-kungfu -- uvx --from "git+https://github.com/kamiour/neo-skills-mcp-workshop#subdirectory=neo-kungfu-mcp" neo-kungfu-mcp
claude mcp add neo-firearms -- uvx --from "git+https://github.com/kamiour/neo-skills-mcp-workshop#subdirectory=neo-firearms-mcp" neo-firearms-mcp
claude mcp add neo-sword -- uvx --from "git+https://github.com/kamiour/neo-skills-mcp-workshop#subdirectory=neo-sword-mcp" neo-sword-mcp

2. Install the skill

Copy skill/SKILL.md to your Claude Code skills directory:

cp skill/SKILL.md ~/.claude/skills/neo-combat/SKILL.md

3. Try it out!

Open Claude Code and try prompts like:

"Agent Smith shoots a gun at you"
"Agent Smith throws a punch"
"Agent Smith swings a sword at your head"
"Agent Smith attacks with a flying kick"
"Fight Agent Smith — he starts with a punch, then pulls out a gun"

Example

Prompt: "You are Neo. Agent Smith fires a gun at you."

Expected response: Neo quotes a dramatic line, the bullet-dodge text art appears, and a cinematic narration describes the scene.

Workshop Flow

Intro to MCP — What are MCP servers? Show neo-kungfu-mcp/src/neo_kungfu_mcp/server.py as a minimal example
Intro to Skills — What is a SKILL.md? Show the structure
Demo — Show the finished Neo skill in action
Hands-on: Install MCP servers — Participants run claude mcp add commands
Hands-on: Write the skill — Build SKILL.md from scratch
Play & experiment — Try different combat prompts

MCP Servers