poi-plugin-mcp 0.2.9 → 0.2.11

package/README.md

@@ -61,11 +61,15 @@ token is never returned by an HTTP endpoint.
 | `/equipment` | Raw owned equipment instance data |
 | `/resources` | Resource array |
 | `/quests` | Active quests and quest records |
+| `/quest-list` | Latest complete quest-page telemetry |
+| `/quest-action` | Latest successful quest start or stop request |
+| `/equipment-action` | Latest successful equipment mutation request |
 | `/airbase` | Land base air squadron data |
 | `/names` | Ship, equipment, and mission name maps |
-| `/master` | Master ship, equipment, ship type, equipment type, and mission data |
+| `/master` | Master ship, equipment, ship type, equipment type, mission, and bounded equipment compatibility data |
 | `/event` | Event ship tag definitions plus owned ships' current sally area |
 | `/planner` | Ship Info deck planner areas and ship assignments |
+| `/battle` | Observed battle packets, official settlement, and compact Prophet state |
 | `/screenshot` | In-memory PNG capture of the game WebView |
 | `/input/status` | Whether authenticated WebView input is enabled |
 | `/input` | Authenticated, serialized WebView input |

package/index.js

@@ -6,6 +6,7 @@ const telemetry = createPoiTelemetry()
 const controller = createBridgeController({
   getQuestList: telemetry.getQuestList,
   getQuestAction: telemetry.getQuestAction,
+  getEquipmentAction: telemetry.getEquipmentAction,
   getBattleTelemetry: telemetry.getBattleTelemetry,
 })
 const settingsClass = createSettingsClass(controller)

package/lib/bridge-controller.js

@@ -32,6 +32,7 @@ function createBridgeController(options = {}) {
       performInput: options.performInput,
       getQuestList: options.getQuestList,
       getQuestAction: options.getQuestAction,
+      getEquipmentAction: options.getEquipmentAction,
       getBattleTelemetry: options.getBattleTelemetry,
       inputEnabled: settings.inputEnabled,
       inputToken,

package/lib/poi-http-bridge.js

@@ -15,18 +15,28 @@ const DEFAULT_PLANNER_FILE = path.join(
   'poi',
   'poi-plugin-ship-info.json',
 )
+const DEFAULT_MASTER_FILE = path.join(
+  process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'),
+  'poi',
+  'navy-album',
+  'master.json',
+)
 const JSONRPC_VERSION = '2.0'
 const MCP_PROTOCOL_VERSION = '2024-11-05'
 const INPUT_BODY_LIMIT = 64 * 1024
+const MASTER_FILE_LIMIT = 16 * 1024 * 1024
 
 function createPoiDataBridge(options = {}) {
   const getStore = options.getStore || defaultGetStore
   const configuredPort = options.port == null ? DEFAULT_PORT : options.port
   const portFile = options.portFile || DEFAULT_PORT_FILE
   const plannerFile = options.plannerFile || DEFAULT_PLANNER_FILE
+  const masterFile = options.masterFile || DEFAULT_MASTER_FILE
   const logger = options.logger || console
   const getQuestList = options.getQuestList || (() => ({ available: false, generation: 0 }))
   const getQuestAction = options.getQuestAction || (() => ({ available: false, generation: 0 }))
+  const getEquipmentAction = options.getEquipmentAction ||
+    (() => ({ available: false, generation: 0 }))
   const getBattleTelemetry = options.getBattleTelemetry ||
     (() => ({ available: false, generation: 0 }))
   const inputEnabled = options.inputEnabled === true
@@ -242,6 +252,11 @@ function createPoiDataBridge(options = {}) {
         return
       }
 
+      if (endpoint === '/equipment-action') {
+        sendJson(res, 200, getEquipmentAction())
+        return
+      }
+
       const store = readStore()
       const info = store.info
 
@@ -274,7 +289,7 @@ function createPoiDataBridge(options = {}) {
           sendJson(res, 200, extractNames(store))
           break
         case '/master':
-          sendJson(res, 200, extractMasterData(store))
+          sendJson(res, 200, extractMasterData(store, masterFile))
           break
         case '/event':
           sendJson(res, 200, extractEventData(store))
@@ -906,7 +921,7 @@ function collectSimpleNames(source, target) {
   }
 }
 
-function extractMasterData(store) {
+function extractMasterData(store, masterFile = DEFAULT_MASTER_FILE) {
   const constants = store.const || {}
 
   return {
@@ -920,9 +935,52 @@ function extractMasterData(store) {
       constants.$slotItemTypes ||
       {},
     missions: constants.$missions || {},
+    equipmentRules: readEquipmentRules(masterFile),
   }
 }
 
+function readEquipmentRules(masterFile) {
+  try {
+    const stat = fs.statSync(masterFile)
+    if (!stat.isFile() || stat.size <= 0 || stat.size > MASTER_FILE_LIMIT) {
+      return { available: false, source: 'navy-album-master-cache' }
+    }
+    const master = JSON.parse(fs.readFileSync(masterFile, 'utf8'))
+    const equipmentShip = objectOrEmpty(master.api_mst_equip_ship)
+    const equipmentExslotTypes = Array.isArray(master.api_mst_equip_exslot)
+      ? master.api_mst_equip_exslot.filter(Number.isInteger)
+      : []
+    const equipmentExslotShip = objectOrEmpty(
+      master.api_mst_equip_exslot_ship,
+    )
+    const equipmentLimitExslot = objectOrEmpty(
+      master.api_mst_equip_limit_exslot,
+    )
+    if (
+      Object.keys(equipmentShip).length === 0 ||
+      equipmentExslotTypes.length === 0
+    ) {
+      return { available: false, source: 'navy-album-master-cache' }
+    }
+    return {
+      available: true,
+      source: 'navy-album-master-cache',
+      equipmentShip,
+      equipmentExslotTypes,
+      equipmentExslotShip,
+      equipmentLimitExslot,
+    }
+  } catch (_) {
+    return { available: false, source: 'navy-album-master-cache' }
+  }
+}
+
+function objectOrEmpty(value) {
+  return value && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : {}
+}
+
 function extractEventData(store) {
   const tags = extractShipTags(store)
   const ships = {}

package/lib/poi-telemetry.js

@@ -3,6 +3,12 @@ const QUEST_ACTION_PATHS = new Set([
   '/kcsapi/api_req_quest/start',
   '/kcsapi/api_req_quest/stop',
 ])
+const EQUIPMENT_ACTION_PATHS = new Set([
+  '/kcsapi/api_req_kaisou/slotset',
+  '/kcsapi/api_req_kaisou/slotset_ex',
+  '/kcsapi/api_req_kaisou/slot_deprive',
+  '/kcsapi/api_req_kaisou/unsetslot_all',
+])
 const BATTLE_RESULT_PATHS = new Set([
   '/kcsapi/api_req_practice/battle_result',
   '/kcsapi/api_req_sortie/battleresult',
@@ -37,6 +43,8 @@ function createPoiTelemetry(options = {}) {
   let questList = null
   let questActionGeneration = 0
   let questAction = null
+  let equipmentActionGeneration = 0
+  let equipmentAction = null
   let battleGeneration = 0
   let battleTelemetry = null
 
@@ -52,6 +60,10 @@ function createPoiTelemetry(options = {}) {
       captureQuestAction(detail)
       return
     }
+    if (EQUIPMENT_ACTION_PATHS.has(detail.path)) {
+      captureEquipmentAction(detail)
+      return
+    }
     if (BATTLE_RESULT_PATHS.has(detail.path)) {
       captureBattleResult(detail)
       return
@@ -79,7 +91,7 @@ function createPoiTelemetry(options = {}) {
       if (!quest || typeof quest !== 'object' || !Number.isInteger(quest.api_no)) {
         return []
       }
-      return [{ ...quest, pageRow: index + 1 }]
+      return [{ ...quest, listIndex: index + 1 }]
     })
 
     questGeneration += 1
@@ -113,6 +125,23 @@ function createPoiTelemetry(options = {}) {
     }
   }
 
+  function captureEquipmentAction(detail) {
+    const apiResult = equipmentApiResult(detail)
+    if (apiResult === 0) return
+    const postBody = normalizeEquipmentPostBody(detail.path, detail.postBody)
+    if (!postBody) return
+
+    equipmentActionGeneration += 1
+    equipmentAction = {
+      available: true,
+      generation: equipmentActionGeneration,
+      capturedAt: now().toISOString(),
+      path: detail.path,
+      apiResult,
+      postBody,
+    }
+  }
+
   function captureBattlePacket(detail) {
     if (!battleTelemetry || battleTelemetry.status === 'settled') {
       battleGeneration += 1
@@ -175,12 +204,85 @@ function createPoiTelemetry(options = {}) {
     getQuestAction() {
       return questAction || { available: false, generation: 0 }
     },
+    getEquipmentAction() {
+      return equipmentAction || { available: false, generation: 0 }
+    },
     getBattleTelemetry() {
       return battleTelemetry || { available: false, generation: 0 }
     },
   }
 }
 
+function normalizeEquipmentPostBody(path, postBody) {
+  if (!postBody || typeof postBody !== 'object') return null
+  if (path === '/kcsapi/api_req_kaisou/slotset') {
+    const shipId = positiveIntegerOrNull(postBody.api_id)
+    const slotIndex = boundedInteger(postBody.api_slot_idx, 0, 4)
+    const itemId = boundedInteger(postBody.api_item_id, -1)
+    if (shipId == null || slotIndex == null || itemId == null) return null
+    return {
+      api_id: shipId,
+      api_slot_idx: slotIndex,
+      api_item_id: itemId,
+    }
+  }
+  if (path === '/kcsapi/api_req_kaisou/slotset_ex') {
+    const shipId = positiveIntegerOrNull(postBody.api_id)
+    const itemId = boundedInteger(postBody.api_item_id, -1)
+    if (shipId == null || itemId == null) return null
+    return {
+      api_id: shipId,
+      api_item_id: itemId,
+    }
+  }
+  if (path === '/kcsapi/api_req_kaisou/slot_deprive') {
+    const setShip = positiveIntegerOrNull(postBody.api_set_ship)
+    const unsetShip = positiveIntegerOrNull(postBody.api_unset_ship)
+    const setIndex = boundedInteger(postBody.api_set_idx, -1, 4)
+    const unsetIndex = boundedInteger(postBody.api_unset_idx, -1, 4)
+    if (
+      setShip == null ||
+      unsetShip == null ||
+      setIndex == null ||
+      unsetIndex == null
+    ) {
+      return null
+    }
+    return {
+      api_set_ship: setShip,
+      api_unset_ship: unsetShip,
+      api_set_idx: setIndex,
+      api_unset_idx: unsetIndex,
+    }
+  }
+  if (path === '/kcsapi/api_req_kaisou/unsetslot_all') {
+    const shipId = positiveIntegerOrNull(postBody.api_id)
+    return shipId == null ? null : { api_id: shipId }
+  }
+  return null
+}
+
+function equipmentApiResult(detail) {
+  const candidates = [
+    detail.apiResult,
+    detail.api_result,
+    detail.result,
+    detail.body && detail.body.api_result,
+  ]
+  for (const candidate of candidates) {
+    const value = toInteger(candidate)
+    if (value != null) return value === 1 ? 1 : 0
+  }
+  return null
+}
+
+function boundedInteger(value, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+  const parsed = toInteger(value)
+  return parsed != null && parsed >= minimum && parsed <= maximum
+    ? parsed
+    : null
+}
+
 function toInteger(value, fallback = null) {
   if (value == null || value === '') return fallback
   const parsed = Number(value)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-mcp",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Poi data, WebView capture, and opt-in authenticated input bridge for local KanColle tools.",
   "main": "index.js",
   "keywords": [