nbrt-mcp

MCP server template for building Model Context Protocol (MCP) servers and tools.

Built with TypeScript, minimal dependencies, and focused on creating one-file-per-tool/resource prompt modules.

Features

• Small MCP server scaffold using @modelcontextprotocol/sdk.
• Example tools, prompts, and resources included (echo, summarizer, metro lookup helpers).
• TypeScript-first, fast iteration with tsx in development and tsdown for production builds.

Requirements

• Node.js (v18+ recommended)
• pnpm (or npm/yarn)

Install

Install dependencies:

pnpm install

Publish and Run

Once published to npm, you can run the server directly with npx:

npx nbrt-mcp

If you prefer a global install:

npm install -g nbrt-mcp

Scripts

Available npm scripts (run with pnpm, npm run, or yarn):

• pnpm dev — run the server over stdio (useful for local testing with Claude Desktop)
• pnpm build — compile to dist/ via tsdown
• pnpm test — run unit tests with vitest
• pnpm typecheck — run tsc --noEmit to type-check the project

These map to the entries in package.json.

Running

Start the server for local development:

pnpm dev

The process listens on stdio and registers tools/resources with an MCP transport.

Project Structure

• src/ — source files
  • src/tools/ — one file per tool, each exports registerXxx(server)
  • src/resources/ — one file per resource, each exports registerXxx(server)
  • src/prompts/ — prompt handlers and helpers
  • src/lib/ — shared helpers and APIs (metro API, stations, directions)
  • src/server.ts — wires everything together via createServer()
  • src/index.ts — stdio transport entry point
• tests/ — unit tests
• data/ — sample static data (e.g., stations.json)

Contributing

• Follow the existing project structure: add one tool/resource per file and export a registration function.
• Keep modules small and focused.
• Run tests with pnpm test before opening PRs.