kungfu-mcp

A humorous Model Context Protocol server, in TypeScript, that catalogs the major factions of the jianghu (the martial-arts underworld) and narrates sparring matches between them.

Built for a presentation demo to illustrate the main building blocks of an MCP server — tools, schema validation, the stdio transport, and the client/server handshake — without taking itself too seriously.

Factions included

Related MCP server: Hilanet MCP

Tools exposed

Quickstart

npm install
npm run build

Try it with the MCP Inspector

npm start

This launches the official @modelcontextprotocol/inspector, where you can call list_factions, get_faction, and spar from a UI.

Or wire it into an MCP client

Add the following to your client's server config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "kungfu": {
      "command": "node",
      "args": ["/absolute/path/to/kungfu-mcp/build/index.js"]
    }
  }
}

Project layout

package.json     # deps, "type":"module", build script
tsconfig.json    # ES2022 / Node16, outDir build
src/
  index.ts       # McpServer instance + 3 tools + stdio transport
  data.ts        # KungfuFaction[] dataset (the heart of the humor)

Notes

• This is a demo. All factions, fun facts, and spar outcomes are fabricated for entertainment.

• The server logs to stderr only (stdout is reserved for JSON-RPC, per MCP stdio transport rules).