Neo Skills MCP Workshop
No description available
Ask AI about Neo Skills MCP Workshop
Powered by Claude Β· Grounded in docs
I know everything about Neo Skills MCP Workshop. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Neo Combat Workshop β MCP Server + Claude Code/Cursor Skill
"I know kung fu." β Neo
A TypeScript MCP server (neo-fight) with eight combat tools, plus a Skill (neo-kungfu) that orchestrates them. Built as a hands-on workshop on creating Skills that leverage MCP tools.
Looking for the workshop scaffold? Switch to the
starterbranch βmainis the completed answer key.
Project Structure
neo-skills-mcp-workshop/
βββ src/
β βββ index.ts # the server (8 tools)
β βββ art.ts # 8 braille art constants
βββ .claude/skills/neo-kungfu/SKILL.md # auto-loaded by Claude Code
βββ .cursor/skills/neo-kungfu/SKILL.md # auto-loaded by Cursor
βββ .cursor/mcp.json # auto-loaded by Cursor
βββ .mcp.json # auto-loaded by Claude Code
βββ package.json
βββ README.md
Both the MCP server config and the skill ship as project-scoped files. Open the repo in your agent and everything wires up automatically.
Skill and MCP config files are duplicated per agent β Cursor and Claude Code don't share a discovery convention, so we ship one of each per side.
Tools
The neo-fight MCP server exposes 8 tools, grouped into 3 combat domains:
| Domain | Tools |
|---|---|
| martial arts | defend_against_kick (with kick_type enum input), defend_against_punch, attack_with_punch, attack_with_kick |
| firearms | dodge_bullet, fire_gun |
| sword | block_sword_attack, attack_with_sword |
Each tool returns a braille text-art scene of Neo performing the action plus a combat log message.
Setup
Prerequisites
- Node.js 18+ and npm
- Claude Code / Cursor is installed and logged in
- Watched The Matrix β for the vibes
Windows users: run all commands in PowerShell or Git Bash (both support
$PWD).cmd.exeworks too but you'll need%CD%instead of$PWD.
Clone, install, open
git clone https://github.com/kamiour/neo-skills-mcp-workshop.git
cd neo-skills-mcp-workshop
npm install # also runs the build via the `prepare` script
Open the project in your agent. You'll get security prompts to approve the MCP server (neo-fight) and the skill (neo-kungfu) β accept both.
| Agent | Auto-load behavior |
|---|---|
| Cursor | Open this folder as a workspace β approve prompts. Verify in Settings β MCP + Settings β Skills. |
| Claude Code | Run claude from the project directory β approve prompts. Verify with claude mcp list and /skills. |
Try it out
Open a chat in your agent and try prompts like:
- "Agent Smith shoots a gun at you"
- "Agent Smith throws a punch"
- "Agent Smith swings a sword at your head"
- "Fight Agent Smith β he starts with a punch, then pulls out a gun"
Inspect tools in a UI (optional)
Want to see schemas and call tools with custom inputs? Use MCP Inspector:
npx @modelcontextprotocol/inspector \
npx -y --package=git+https://github.com/kamiour/neo-skills-mcp-workshop.git neo-fight-mcp
A session URL prints in the terminal β open it in a browser. Try the Tools tab β defend_against_kick β fill in kick_type from the dropdown β click Run.
Port collision? Inspector listens on 6274. Override with
CLIENT_PORT=6275 npx @modelcontextprotocol/inspector ....
Development (for contributors)
npm install # also runs the build via the `prepare` script
npm run build # rebuild after source changes
Tech Stack
- TypeScript with
tsccompile tobuild/ @modelcontextprotocol/sdkβ official MCP TypeScript SDKzodβ input schemas (used by thedefend_against_kickreference tool)- stdio transport β simplest for local development
