Neo Skills MCP Workshop

新格斗工坊——MCP服务器+克劳德代码/光标技能

“我懂功夫。”——尼奥

TypeScript MCP服务器(neo-fight)拥有八种战斗工具，外加一项技能(neo-kungfu)这是对他们的精心策划。作为一个关于创建利用MCP工具的技能的实践研讨会而建立。

在找车间脚手架吗？ 切换到 starter 分支机构-- main 是已完成的答案密钥。

项目结构

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

MCP服务器配置和技能都是项目范围的文件。在代理中打开仓库，所有内容都会自动连接起来。

*每个代理的技能和MCP配置文件都是重复的——Cursor和Claude Code不共享发现约定，所以我们每方都提供一个。*

工具

这 neo-fight MCP服务器公开了8个工具，分为3个作战域：

每个工具都会返回一个盲文文本艺术场景，显示尼奥执行动作，以及一条战斗日志消息。

设置

先决条件

• Node.js 18+ 和 npm
• 克劳德代码 / 光标 已安装并登录
• 注视 黑客帝国 --为了氛围

Windows用户： 在中运行所有命令 PowerShell 或 命令行 （两者都支持 $PWD). cmd.exe 也可以，但你需要 %CD% 而不是 $PWD.

克隆、安装、打开

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

在代理中打开项目。您将收到批准MCP服务器的安全提示(neo-fight)以及技能(neo-kungfu)--两者都接受。

试试看

在您的代理中打开聊天，并尝试以下提示：

• “史密斯探员向你开枪”
• “史密斯探员挥拳”
• “史密斯探员用剑指着你的头”
• “战斗特工史密斯——他先是挥拳，然后拔出枪”

检查UI中的工具（可选）

想要查看具有自定义输入的模式和调用工具吗？使用 MCP检查员:

npx @modelcontextprotocol/inspector \
  npx -y --package=git+https://github.com/kamiour/neo-skills-mcp-workshop.git neo-fight-mcp

在终端中打印会话URL——在浏览器中打开它。试试 工具 tab → defend_against_kick → 填写 kick_type 从下拉列表中→ click 跑.

港口碰撞？ 检查员在听 6274.用覆盖 CLIENT_PORT=6275 npx @modelcontextprotocol/inspector ....

开发（供贡献者使用）

npm install        # also runs the build via the `prepare` script
npm run build      # rebuild after source changes

技术栈

• TypeScript 和 tsc 编译到 build/
• @modelcontextprotocol/sdk --官方MCP TypeScript SDK
• zod --输入模式（由 defend_against_kick 参考工具）
• stdio传输 --最适合当地发展