BoJ-server

Instructions

Implementation Reference

• mcp-bridge/main.js:644-651 (handler)

  Tool handler logic for 'boj_cartridges' in the main message switch.

  case "boj_cartridges": {
    const matrix = await fetchCartridges();
    sendResult(id, {
      content: [
        { type: "text", text: JSON.stringify(matrix, null, 2) },
      ],
    });
    break;

• mcp-bridge/main.js:104-110 (helper)

  Helper function to fetch the cartridge matrix from the BoJ REST API.

  async function fetchCartridges() {
    try {
      const res = await fetch(`${BOJ_BASE}/cartridges`);
      return await res.json();
    } catch {
      return { note: "Offline mode — cartridge matrix available when BoJ REST API is running", cartridges: Object.keys(OFFLINE_MENU.tier_teranga.concat(OFFLINE_MENU.tier_shield).reduce((acc, c) => { acc[c.name] = c.domain; return acc; }, {})) };
    }

• mcp-bridge/main.js:313-318 (registration)

  Registration of the 'boj_cartridges' tool in the tool listing function.

  tools.push({
    name: "boj_cartridges",
    description:
      "Show the BoJ cartridge matrix — protocol x domain grid showing which cartridges serve which protocol/domain combinations",
    inputSchema: { type: "object", properties: {} },
  });