# ttt-mcp — Tic-Tac-Toe MCP Server

A minimal MCP server exposing a tic-tac-toe game as tools, intended to be played by Claude (via Claude Desktop) against a human via chat.

## Tools exposed

- `new_game` — reset to empty board, X to move
- `get_state` — return current board + status
- `make_move(row, col)` — place the current player's mark; server alternates turns

## Setup

```bash
cd ttt-mcp
npm install
npm run build
```

## Wire it into Claude Desktop

Edit your `claude_desktop_config.json`:

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add (or merge into) this:

```json
{
  "mcpServers": {
    "tic-tac-toe": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/ttt-mcp/dist/index.js"]
    }
  }
}
```

Replace the path with your actual absolute path. **Then fully quit and restart Claude Desktop.**

## Verify it loaded

In Claude Desktop, open a new chat and look for the MCP tools indicator (slider/plug icon near the input). You should see `tic-tac-toe` listed with three tools.

If it's missing, check Claude Desktop's MCP logs:
- macOS: `~/Library/Logs/Claude/mcp*.log`

## Test outside Claude Desktop

You can poke the server directly with the official inspector:

```bash
npm run inspect
```

This launches a web UI that lets you call the tools manually — handy for debugging.

## Playing

In Claude Desktop chat, just say: *"Let's play tic-tac-toe. You start."*

I'll call `new_game`, make a move, and we go from there. When it's your turn, tell me your move ("row 1 column 2") and I'll call `make_move` on your behalf, then take my own turn.

## What to add next

- Per-conversation game state (currently single global state)
- AI difficulty levels (right now I just decide moves myself in chat)
- Replay history / undo
- Multiple game rooms
- Web frontend that subscribes to state changes