# Node MCP Template

Opinionated template for building Node.js stdio and HTTP MCP servers.

## Features

- Stdio/HTTP MCP server examples using [`@modelcontextprotocol/server`](https://github.com/modelcontextprotocol/typescript-sdk/tree/main/packages/server).
- Stdio MCP client example using [`@modelcontextprotocol/client`](https://github.com/modelcontextprotocol/typescript-sdk/tree/main/packages/client).
- Agent-oriented example tools:
  * `read_file`
  * `write_file`
  * `edit_file`
  * `glob_search`
  * `grep_search`
  * `exec_shell`
  * `apply_diff`

## Usage

Debug with the MCP [inspector](https://github.com/modelcontextprotocol/inspector):

```sh
npm start
```

The inspector starts a local web UI at `http://localhost:6274`.

## Agents

Edit [AGENTS.md](./AGENTS.md) after creating a project from this template. Add project-specific instructions to keep the development workflow accurate.

## Minimum Supported Node Version

Requires [22.18.0](https://github.com/nodejs/node/releases/tag/v22.18.0) or higher for TypeScript.