# MCP Server Example

A minimal example [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server
built with the official TypeScript SDK (`@modelcontextprotocol/sdk`). It communicates over
stdio and demonstrates the three core MCP primitives:

- **Tools** — callable functions:
  - `add(a, b)` — adds two numbers.
  - `get-weather(city)` — returns a mock weather report.
  - `save-note(key, text)` — saves a note in memory.
- **Resources** — readable data:
  - `notes://list` — lists all saved notes as JSON.
- **Prompts** — reusable prompt templates:
  - `summarize-notes` — asks the model to summarize all saved notes.

## Setup

```bash
npm install
npm run build
```

## Run

```bash
npm start
```

The server communicates over stdio, so it's meant to be launched by an MCP client
(e.g. Claude Desktop, VS Code, or the GitHub Copilot CLI), not run interactively.

## Configure with an MCP client

Example client config (e.g. `claude_desktop_config.json` or similar):

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

## Debugging

Use the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector) to
test the server interactively without a full client:

```bash
npx @modelcontextprotocol/inspector node build/index.js
```

## Project structure

```
mcp-server-example/
├── src/
│   └── index.ts      # Server implementation (tools, resources, prompts)
├── package.json
├── tsconfig.json
└── README.md
```