┌────────────────────────────────────────┐
                 │   servers/todo/core.ts                 │
                 │   3 tools · 1 resource · 1 prompt      │
                 └──┬──────────────┬──────────────┬───────┘
        stdio ──────┘              │              └────── Streamable HTTP
          │                 Streamable HTTP            (public · API key · HTTPS)
          │                    (localhost)                       │
     MemoryStore             MemoryStore                     FileStore
          │                        │                              │
          └────────────────────────┼──────────────────────────────┘
                                   │  3 MCP client, tool đã namespace
                 ┌─────────────────┴──────────────────────┐
                 │  src/  — AGENT = HOST                  │
                 │  8 tool local + 7 tool MCP + use_skill │
                 └────────────────────────────────────────┘

# 1. Còn sống không?
curl https://ia02-mcp-server.dsa-bus-booking.io.vn/health

# 2. Không có khoá -> 401 (cổng auth đang đóng đúng)
curl -i -X POST https://ia02-mcp-server.dsa-bus-booking.io.vn/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"grader","version":"1"}}}'

# 3. Có khoá -> bắt tay thành công
curl -X POST https://ia02-mcp-server.dsa-bus-booking.io.vn/mcp \
  -H "Authorization: Bearer $MCP_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"grader","version":"1"}}}'

claude mcp add --transport http todo https://ia02-mcp-server.dsa-bus-booking.io.vn/mcp \
  --header "Authorization: Bearer <MCP_KEY>"

npm install
cp .env.example .env        # rồi điền DEEPSEEK_API_KEY của bạn

# ① server HTTP local (cổng 3030)
npm run server:http

# ② agent — tự spawn server stdio, tự nối tới HTTP local + HTTPS public
npm run agent

you › /mcp                       # trạng thái 3 server
you › /tools                     # tool nào đến từ MCP
you › thêm "nộp bài IA02" vào todo rồi cho tôi xem danh sách
you › standup time               # khớp mô tả skill -> agent tự gọi use_skill

npm run agent -- 'thêm "finish MCP homework" vào todo rồi liệt kê'

// src/tools.ts
export interface Tool {
  name: string;
  description: string;
  schema: JsonSchema;
  run(args: Record<string, any>): Promise<string>;
}

const cfg    = loadConfig('./config.json');            // ① load config
const local  = createLocalTools(cfg, guard, approval);
const mcp    = await connectServers(cfg.mcpServers);   // stdio + HTTP + HTTPS
const skills = loadSkills(cfg.skillsRoot);

const registry = createRegistry([                       // ② merge tools
  ...local,
  ...mcp.tools,                                         //    todo__add_task, …
  skills.useSkillTool,
]);                                                     // ③ dispatch ở trong registry

tools.push({
  name: `${alias}__${t.name}`,                          // namespace
  description: `[mcp:${alias}] ${t.description}`,
  schema: t.inputSchema,
  run: async (args) => textOf(await client.callTool({ name: t.name, arguments: args })),
});

npm run build
npx @modelcontextprotocol/inspector node dist/servers/todo/stdio.js

npx @modelcontextprotocol/inspector --cli node dist/servers/todo/stdio.js --method tools/list
npx @modelcontextprotocol/inspector --cli node dist/servers/todo/stdio.js --method resources/list
npx @modelcontextprotocol/inspector --cli node dist/servers/todo/stdio.js --method prompts/list
npx @modelcontextprotocol/inspector --cli node dist/servers/todo/stdio.js \
  --method tools/call --tool-name add_task --tool-arg text="finish MCP homework"

you › standup time
  → use_skill {"name":"daily-standup"}      # khớp description, agent tự gọi
  → todo__list_tasks {}
  → mcp_read_resource {"server":"todo","uri":"todo://list"}
  → write_file {"path":"standup.md", ...}

push main
  └─ check   : typecheck + 50 test
  └─ build   : Docker multi-stage -> ghcr.io/nban22/ia02-mcp-server:main-<sha> + :latest
  └─ deploy  : ssh VPS -> docker login ghcr -> compose up -d --pull always
               └─ smoke: /health 200 · POST /mcp không key = 401 · có key = 200

proxy_buffering off;
proxy_cache off;
gzip off;
proxy_read_timeout 3600s;

src/                          agent host — 10 file phẳng
  main.ts        entry: load config · merge tools · start REPL
  config.ts      loadConfig + ${ENV} expand + parse mcpServers
  agent.ts       vòng lặp think→act→observe + session + system prompt
  model.ts       client OpenAI-compatible + tách thinking + map lỗi
  repl.ts        REPL và các lệnh /mcp /resources /prompts /skills
  term.ts        màu ANSI + I/O terminal (TTY và pipe)
  tools.ts       interface Tool + registry + path guard + cổng duyệt
  tools.local.ts 8 tool: file · shell · search
  mcp.ts         ★ CẢ phần host: connect · list · namespace · route
  skills.ts      ★ CẢ phần skill: index frontmatter + use_skill

servers/todo/
  core.ts        ★ toàn bộ logic server: 3 tool + resource + prompt
  store.ts       TaskStore: MemoryStore | FileStore
  stdio.ts       nhà số 1
  http.ts        nhà số 2 và 3 (Express + API key + REST + /health)

skills/          daily-standup (lái tool MCP) · feature-dev
deploy/          compose + nginx mẫu
test/            50 test node:test

// Ollama local (slide 43) — nhớ giảm số server để tool list ngắn lại
{
  "provider": "ollama",
  "baseURL": "http://localhost:11434/v1",
  "model": "qwen3:4b",
  "apiKey": "ollama"
}