poi-plugin-mcp 0.2.0

package/README.md

@@ -0,0 +1,76 @@
+# poi-plugin-mcp
+
+Poi plugin that starts a local HTTP bridge inside Poi so CLI/MCP agents can read current KanColle data.
+
+This package is maintained inside the repository root. Do not install it manually from this folder unless you know what you are doing; prefer the root setup flow.
+
+## Install From Repo Root
+
+```powershell
+npm install
+npm run install:poi
+```
+
+Then restart Poi and enable `MCP 数据桥` / `KanColle Data Bridge` if needed.
+
+The installer creates:
+
+```text
+%APPDATA%\poi\plugins\node_modules\poi-plugin-mcp -> <repo>\packages\poi-plugin-mcp
+```
+
+## Settings
+
+The Poi plugin settings panel supports:
+
+- changing the HTTP port, saved in `~/.poi-mcp/settings.json`
+- manually starting and stopping the local bridge
+
+The default port is `17777`.
+
+## HTTP Endpoints
+
+| Endpoint | Data |
+|---|---|
+| `/health` | Bridge status |
+| `/basic` | Admiral profile |
+| `/fleets` | Raw Poi fleet data |
+| `/ships` | Raw owned ship instance data |
+| `/equipment` | Raw owned equipment instance data |
+| `/resources` | Resource array |
+| `/quests` | Active quests and quest records |
+| `/airbase` | Land base air squadron data |
+| `/names` | Ship, equipment, and mission name maps |
+| `/master` | Master ship, equipment, ship type, equipment type, and mission data |
+| `/event` | Event ship tag definitions plus owned ships' current sally area |
+| `/planner` | Ship Info deck planner areas and ship assignments |
+| `/all` | Combined basic runtime data |
+
+## MCP Endpoint
+
+The same local server also exposes a JSON-RPC MCP endpoint:
+
+```text
+POST http://127.0.0.1:17777/mcp
+```
+
+It supports `initialize`, `ping`, `resources/list`, `resources/read`,
+`tools/list`, and `tools/call`. Resource URIs mirror the HTTP endpoints,
+including `poi://ships`, `poi://equipment`, `poi://resources`, `poi://master`,
+`poi://event`, and `poi://planner`.
+
+Available tools:
+
+- `get_fleet_status`
+- `search_ships`
+- `search_equipment`
+- `get_resources`
+- `get_all`
+
+## Verification
+
+From the repo root:
+
+```powershell
+npm run test:plugin
+```

package/index.js

@@ -0,0 +1,25 @@
+const { createBridgeController } = require('./lib/bridge-controller')
+const { createSettingsClass } = require('./lib/settings-view')
+
+const controller = createBridgeController()
+const settingsClass = createSettingsClass(controller)
+
+function pluginDidLoad() {
+  controller.load().catch((error) => {
+    console.error('[poi-plugin-mcp] Failed to start:', error.message)
+  })
+}
+
+function pluginWillUnload() {
+  controller.unload().catch((error) => {
+    console.error('[poi-plugin-mcp] Failed to stop:', error.message)
+  })
+}
+
+module.exports = {
+  pluginDidLoad,
+  pluginWillUnload,
+  settingClass: settingsClass,
+  settingsClass,
+  _controller: controller,
+}

package/lib/bridge-controller.js

@@ -0,0 +1,118 @@
+const { createPoiDataBridge } = require('./poi-http-bridge')
+const {
+  DEFAULT_SETTINGS_FILE,
+  loadSettings,
+  normalizeSettings,
+  saveSettings,
+} = require('./settings')
+
+function createBridgeController(options = {}) {
+  const settingsPath = options.settingsPath || DEFAULT_SETTINGS_FILE
+  const logger = options.logger || console
+  const createBridge = options.createBridge || createPoiDataBridge
+
+  let settings = loadSettings(settingsPath)
+  let bridge = null
+  let pending = Promise.resolve()
+
+  function enqueue(action) {
+    pending = pending.then(action, action)
+    return pending
+  }
+
+  function createCurrentBridge() {
+    return createBridge({
+      getStore: options.getStore,
+      port: settings.port,
+      portFile: options.portFile,
+      logger,
+    })
+  }
+
+  async function ensureStarted() {
+    if (!bridge) {
+      bridge = createCurrentBridge()
+    }
+    await bridge.start()
+  }
+
+  async function stopCurrentBridge() {
+    if (!bridge) return
+
+    const runningBridge = bridge
+    bridge = null
+    await runningBridge.stop()
+  }
+
+  function persist(nextSettings) {
+    settings = saveSettings(normalizeSettings(nextSettings), settingsPath)
+    return settings
+  }
+
+  return {
+    load() {
+      return enqueue(async () => {
+        settings = loadSettings(settingsPath)
+        if (settings.enabled) await ensureStarted()
+      })
+    },
+
+    unload() {
+      return enqueue(async () => {
+        await stopCurrentBridge()
+      })
+    },
+
+    startBridge() {
+      return enqueue(async () => {
+        persist({ ...settings, enabled: true })
+        await ensureStarted()
+      })
+    },
+
+    stopBridge() {
+      return enqueue(async () => {
+        persist({ ...settings, enabled: false })
+        await stopCurrentBridge()
+      })
+    },
+
+    applySettings(nextSettings) {
+      return enqueue(async () => {
+        const normalized = normalizeSettings({ ...settings, ...nextSettings })
+        const portChanged = normalized.port !== settings.port
+        const enabledChanged = normalized.enabled !== settings.enabled
+
+        persist(normalized)
+
+        if (!settings.enabled) {
+          await stopCurrentBridge()
+          return
+        }
+
+        if (portChanged || enabledChanged || !bridge) {
+          await stopCurrentBridge()
+          await ensureStarted()
+        }
+      })
+    },
+
+    getSettings() {
+      return { ...settings }
+    },
+
+    getStatus() {
+      const actualPort = bridge ? bridge.getPort() : 0
+      return {
+        enabled: settings.enabled,
+        running: actualPort > 0,
+        port: settings.port,
+        actualPort,
+      }
+    },
+  }
+}
+
+module.exports = {
+  createBridgeController,
+}