MCP 클라이언트

// MCP 메시지 왕복 — MCP 클라이언트와 서버는 정해진 메시지로만 대화한다.
// list_tools(도구 목록)와 call_tool(도구 실행) 왕복을 로컬에서 그대로 재현한다.
// Claude API·네트워크 없이, 서버가 어떤 순서로 메시지를 주고받는지만 본다.

// ── MCP 서버 — 도구 둘을 가진 메모리 서버(2장의 그 docs 예시 그대로) ──
const docs = {
  "report.pdf": "1분기 매출은 전년 대비 12% 늘었다.",
  "plan.md": "다음 스프린트 목표: 온보딩 개선.",
};

const server = {
  // 서버가 제공하는 도구 목록 — list_tools 요청에 이 스키마를 돌려준다.
  tools: {
    read_document: {
      description: "문서 내용을 문자열로 읽어 돌려준다.",
      run: function (args) {
        if (!(args.doc_id in docs)) throw new Error("문서 없음: " + args.doc_id);
        return docs[args.doc_id];
      },
    },
    edit_document: {
      description: "문서에서 old_str 을 new_str 로 찾아 치환한다.",
      run: function (args) {
        if (!(args.doc_id in docs)) throw new Error("문서 없음: " + args.doc_id);
        docs[args.doc_id] = docs[args.doc_id].split(args.old_str).join(args.new_str);
        return "치환 완료: " + args.doc_id;
      },
    },
  },
  // 서버는 들어온 메시지 종류에 따라 응답 메시지를 만든다.
  handle: function (msg) {
    if (msg.method === "list_tools") {
      const list = Object.keys(this.tools).map(function (name) {
        return { name: name, description: server.tools[name].description };
      });
      return { type: "list_tools_result", tools: list };
    }
    if (msg.method === "call_tool") {
      try {
        const out = this.tools[msg.params.name].run(msg.params.args);
        return { type: "call_tool_result", ok: true, content: out };
      } catch (e) {
        return { type: "call_tool_result", ok: false, content: e.message };
      }
    }
    return { type: "error", content: "모르는 메시지: " + msg.method };
  },
};

// ── 전송(transport) — 클라이언트와 서버 사이를 지나는 모든 메시지를 찍는다 ──
let seq = 0;
function send(direction, msg) {
  seq++;
  console.log("[" + seq + "] " + direction + "  " + JSON.stringify(msg));
}

// MCP 클라이언트 — 서버로 요청을 보내고 응답을 받는 통로.
const client = {
  request: function (msg) {
    send("client → server", msg);
    const res = server.handle(msg);
    send("server → client", res);
    return res;
  },
};

// ── 여기서부터 직접 고쳐 보세요 ──
// 어떤 도구를, 어떤 인자로 부를지 바꿔 보세요.
// 예) edit_document 로 바꾸고 args: { doc_id: "report.pdf", old_str: "12%", new_str: "20%" }
const toolCall = { name: "read_document", args: { doc_id: "report.pdf" } };

// 전체 흐름 — ① 도구 목록을 받고 ② 그중 하나를 실행한다.
console.log("── ① 도구 목록 요청 ──");
const listed = client.request({ method: "list_tools" });
console.log("서버가 알린 도구: " +
  listed.tools.map(function (t) { return t.name; }).join(", "));

console.log("");
console.log("── ② 도구 실행 요청 ──");
const called = client.request({ method: "call_tool", params: toolCall });
console.log(called.ok
  ? "결과: " + called.content
  : "실패: " + called.content);