poi-plugin-mcp 0.2.0

package/lib/settings-view.js

@@ -0,0 +1,184 @@
+function loadReact() {
+  try {
+    return require('react')
+  } catch (_) {
+    if (typeof window !== 'undefined' && window.React) return window.React
+    return null
+  }
+}
+
+function createSettingsClass(controller) {
+  return function PoiMcpSettings() {
+    const React = loadReact()
+
+    if (React && React.useState) {
+      return renderStatefulSettings(React, controller)
+    }
+
+    return renderStaticSettings(createFallbackElement, controller)
+  }
+}
+
+function renderStatefulSettings(React, controller) {
+  const e = React.createElement
+  const [status, setStatus] = React.useState(() => controller.getStatus())
+  const [portText, setPortText] = React.useState(() => String(status.port))
+  const [busy, setBusy] = React.useState(false)
+  const [message, setMessage] = React.useState('')
+
+  async function run(action, successMessage) {
+    setBusy(true)
+    setMessage('')
+    try {
+      await action()
+      const nextStatus = controller.getStatus()
+      setStatus(nextStatus)
+      setPortText(String(nextStatus.port))
+      setMessage(successMessage)
+    } catch (error) {
+      setMessage(error && error.message ? error.message : String(error))
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const port = Number(portText)
+  const validPort = Number.isInteger(port) && port >= 1 && port <= 65535
+
+  return renderSettings(e, {
+    busy,
+    message,
+    port,
+    portText,
+    status,
+    validPort,
+    onPortChange: (event) => setPortText(event.target.value),
+    onApply: () => run(
+      () => controller.applySettings({ port, enabled: status.enabled }),
+      'Port saved',
+    ),
+    onToggle: () => run(
+      () => (status.running ? controller.stopBridge() : controller.startBridge()),
+      status.running ? 'Stopped' : 'Started',
+    ),
+  })
+}
+
+function renderStaticSettings(e, controller) {
+  const status = controller.getStatus()
+  const port = status.port
+
+  return renderSettings(e, {
+    busy: false,
+    message: '',
+    port,
+    portText: String(port),
+    status,
+    validPort: true,
+    onPortChange: null,
+    onApply: async () => {
+      const input = typeof document !== 'undefined' ? document.getElementById('poi-mcp-port') : null
+      const nextPort = input ? Number(input.value) : port
+      await controller.applySettings({ port: nextPort, enabled: status.enabled })
+    },
+    onToggle: () => (status.running ? controller.stopBridge() : controller.startBridge()),
+  })
+}
+
+function renderSettings(e, props) {
+  const statusText = props.status.running
+    ? `Running on 127.0.0.1:${props.status.actualPort}`
+    : 'Stopped'
+
+  return e('div', { style: styles.root },
+    e('div', { style: styles.row },
+      e('label', { style: styles.label, htmlFor: 'poi-mcp-port' }, 'Port'),
+      e('input', {
+        id: 'poi-mcp-port',
+        type: 'number',
+        min: 1,
+        max: 65535,
+        value: props.onPortChange ? props.portText : undefined,
+        defaultValue: props.onPortChange ? undefined : props.portText,
+        disabled: props.busy,
+        style: styles.input,
+        onChange: props.onPortChange,
+      }),
+      e('button', {
+        type: 'button',
+        disabled: props.busy || !props.validPort,
+        style: styles.button,
+        onClick: props.onApply,
+      }, 'Apply'),
+    ),
+    e('div', { style: styles.row },
+      e('span', { style: styles.label }, 'Service'),
+      e('button', {
+        type: 'button',
+        disabled: props.busy,
+        style: styles.button,
+        onClick: props.onToggle,
+      }, props.status.running ? 'Stop' : 'Start'),
+      e('span', { style: styles.status }, statusText),
+    ),
+    e('div', { style: styles.note },
+      'Pi extension defaults to 127.0.0.1:17777; keep this port unless you also update Pi.',
+    ),
+    props.message ? e('div', { style: styles.message }, props.message) : null,
+  )
+}
+
+function createFallbackElement(type, props, ...children) {
+  const nextProps = { ...(props || {}) }
+  if (children.length === 1) nextProps.children = children[0]
+  if (children.length > 1) nextProps.children = children
+
+  return {
+    $$typeof: Symbol.for('react.element'),
+    type,
+    key: nextProps.key == null ? null : String(nextProps.key),
+    ref: nextProps.ref == null ? null : nextProps.ref,
+    props: nextProps,
+    _owner: null,
+  }
+}
+
+const styles = {
+  root: {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 12,
+    maxWidth: 560,
+  },
+  row: {
+    alignItems: 'center',
+    display: 'flex',
+    gap: 8,
+  },
+  label: {
+    flex: '0 0 80px',
+    fontWeight: 600,
+  },
+  input: {
+    width: 120,
+  },
+  button: {
+    minWidth: 72,
+  },
+  status: {
+    color: '#59636e',
+  },
+  note: {
+    color: '#59636e',
+    fontSize: 12,
+    lineHeight: 1.4,
+  },
+  message: {
+    color: '#1f6feb',
+    fontSize: 12,
+  },
+}
+
+module.exports = {
+  createSettingsClass,
+}

package/lib/settings.js

@@ -0,0 +1,51 @@
+const fs = require('fs')
+const os = require('os')
+const path = require('path')
+
+const DEFAULT_SETTINGS = Object.freeze({
+  port: 17777,
+  enabled: true,
+})
+
+const DEFAULT_SETTINGS_FILE = path.join(os.homedir(), '.poi-mcp', 'settings.json')
+
+function normalizeSettings(input = {}) {
+  const port = normalizePort(input.port)
+  return {
+    port: port == null ? DEFAULT_SETTINGS.port : port,
+    enabled: typeof input.enabled === 'boolean' ? input.enabled : DEFAULT_SETTINGS.enabled,
+  }
+}
+
+function normalizePort(value) {
+  if (value == null || value === '') return null
+
+  const port = Number(value)
+  if (!Number.isInteger(port) || port < 1 || port > 65535) return null
+  return port
+}
+
+function loadSettings(settingsPath = DEFAULT_SETTINGS_FILE) {
+  try {
+    const raw = fs.readFileSync(settingsPath, 'utf8')
+    return normalizeSettings(JSON.parse(raw))
+  } catch (_) {
+    return { ...DEFAULT_SETTINGS }
+  }
+}
+
+function saveSettings(settings, settingsPath = DEFAULT_SETTINGS_FILE) {
+  const normalized = normalizeSettings(settings)
+  fs.mkdirSync(path.dirname(settingsPath), { recursive: true })
+  fs.writeFileSync(settingsPath, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8')
+  return normalized
+}
+
+module.exports = {
+  DEFAULT_SETTINGS,
+  DEFAULT_SETTINGS_FILE,
+  loadSettings,
+  normalizePort,
+  normalizeSettings,
+  saveSettings,
+}

package/mcp-server.js

@@ -0,0 +1,397 @@
+#!/usr/bin/env node
+// poi-mcp — MCP Server for KanColle game data
+//
+// 两种使用方式:
+//   方式 A: 配合 POI DevTools 脚本 (推荐, 最稳定)
+//   方式 B: 配合 POI 的 --remote-debugging-port
+//
+// ── 快速开始 ──
+// 1. 启动 POI，进入游戏母港
+// 2. POI 菜单 → 开发工具 → 切换开发工具 (F12)
+// 3. 在 Console 中粘贴下面这段脚本:
+//
+//    fetch('https://raw.githubusercontent.com/your/poi-plugin-mcp/main/inject.js')
+//      .then(r => r.text())
+//      .then(eval)
+//
+// 4. 脚本会自动启动 HTTP 服务并写入端口号到 ~/.poi-mcp/port
+// 5. 然后运行: node mcp-server.js
+//
+// ── 备用方案: 粘贴下面脚本到 Console ──
+// (function(){
+//   var port = 17777;
+//   var http = new XMLHttpRequest();
+//   http.open('GET', 'http://127.0.0.1:' + port + '/health', true);
+//   http.onload = function() {
+//     if (http.status === 200) console.log('[poi-mcp] Server already running on port', port);
+//   };
+//   http.send();
+//   var s = document.createElement('script');
+//   s.src = 'data:text/javascript,' + encodeURIComponent([
+//     'var p='+port+';',
+//     'var gs=function(){return window.getStore()};',
+//     'var s=require("http").createServer(function(q,r){',
+//     '  r.setHeader("Access-Control-Allow-Origin","*");',
+//     '  r.setHeader("Content-Type","application/json");',
+//     '  var u=q.url;',
+//     '  if(u==="/health"){r.end('+JSON.stringify(JSON.stringify({status:"ok"}))+')}',
+//     '  else if(u==="/fleets"){r.end(JSON.stringify(gs().info.fleets))}',
+//     '  else if(u==="/ships"){r.end(JSON.stringify(gs().info.ships))}',
+//     '  else if(u==="/equipment"){r.end(JSON.stringify(gs().info.equips))}',
+//     '  else if(u==="/resources"){r.end(JSON.stringify(gs().info.resources))}',
+//     '  else if(u==="/quests"){r.end(JSON.stringify({activeQuests:gs().info.quests.activeQuests,records:gs().info.quests.records}))}',
+//     '  else if(u==="/airbase"){r.end(JSON.stringify(gs().info.airbase))}',
+//     '  else if(u==="/basic"){r.end(JSON.stringify(gs().info.basic))}',
+//     '  else if(u==="/all"){r.end(JSON.stringify(gs().info))}',
+//     '  else{r.writeHead(404);r.end("Not found")}',
+//     '});',
+//     's.listen(p,"127.0.0.1",function(){',
+//     '  require("fs").writeFileSync("'+require('path').join(os.homedir(),'.poi-mcp','port').replace(/\\/g,'/')+'",String(p),"utf8");',
+//     '  console.log("[poi-mcp] API running on http://127.0.0.1:"+p);',
+//     '});'
+//   ].join(''));
+//   document.head.appendChild(s);
+// })();
+
+const os = require('os')
+const path = require('path')
+const fs = require('fs')
+const http = require('http')
+
+const PORT_FILE = path.join(os.homedir(), '.poi-mcp', 'port')
+
+// ─── POI HTTP API Client ─────────────────────────────────────────────────────
+
+function getPoiPort() {
+  try {
+    return parseInt(fs.readFileSync(PORT_FILE, 'utf8').trim(), 10)
+  } catch (_) {
+    return null
+  }
+}
+
+function fetchFromPoi(endpoint) {
+  return new Promise((resolve, reject) => {
+    const port = getPoiPort()
+    if (!port) {
+      return reject(new Error(
+        'POI data API not found.\n\n' +
+        'Please:\n' +
+        '  1. Open POI → F12 (DevTools) → Console tab\n' +
+        '  2. Paste this script and press Enter:\n\n' +
+        '─── PASTE THIS INTO POI CONSOLE ───\n' +
+        getInjectScript() +
+        '\n─── END ───\n\n' +
+        '  3. Then run this MCP server again.'
+      ))
+    }
+    http.get(`http://127.0.0.1:${port}${endpoint}`, (res) => {
+      let data = ''
+      res.on('data', chunk => data += chunk)
+      res.on('end', () => {
+        try { resolve(JSON.parse(data)) } catch (e) { reject(e) }
+      })
+    }).on('error', reject).setTimeout(10000, function() {
+      this.destroy()
+      reject(new Error('Request timed out'))
+    })
+  })
+}
+
+function getInjectScript() {
+  return [
+    '(function(){',
+    'var p=17777;',
+    'var s=require("http").createServer(function(q,r){',
+    '  r.setHeader("Access-Control-Allow-Origin","*");',
+    '  r.setHeader("Content-Type","application/json");',
+    '  try{',
+    '    var st=window.getStore();',
+    '    if(!st||!st.info)throw new Error("Store not ready");',
+    '    var u=q.url;',
+    '    if(u==="/health"){r.end(JSON.stringify({status:"ok"}))}',
+    '    else if(u==="/fleets"){r.end(JSON.stringify(st.info.fleets||[]))}',
+    '    else if(u==="/ships"){r.end(JSON.stringify(st.info.ships||{}))}',
+    '    else if(u==="/equipment"){r.end(JSON.stringify(st.info.equips||{}))}',
+    '    else if(u==="/resources"){r.end(JSON.stringify(st.info.resources||[]))}',
+    '    else if(u==="/quests"){r.end(JSON.stringify({activeQuests:st.info.quests?.activeQuests||{},records:st.info.quests?.records||{}}))}',
+    '    else if(u==="/airbase"){r.end(JSON.stringify(st.info.airbase||[]))}',
+    '    else if(u==="/basic"){r.end(JSON.stringify(st.info.basic||{}))}',
+    '    else if(u==="/all"){r.end(JSON.stringify({',
+    '      basic:st.info.basic,',
+    '      fleets:st.info.fleets,',
+    '      ships:st.info.ships,',
+    '      equipment:st.info.equips,',
+    '      resources:st.info.resources,',
+    '      quests:{activeQuests:st.info.quests?.activeQuests,records:st.info.quests?.records},',
+    '      airbase:st.info.airbase',
+    '    }))}',
+    '    else{r.writeHead(404);r.end("Not found")}',
+    '  }catch(e){r.writeHead(500);r.end(e.message)}',
+    '});',
+    's.listen(p,"127.0.0.1",function(){',
+    '  var d=require("path").join(require("os").homedir(),".poi-mcp");',
+    '  try{require("fs").mkdirSync(d,{recursive:true})}catch(e){}',
+    '  require("fs").writeFileSync(require("path").join(d,"port"),String(p),"utf8");',
+    '  console.log("[poi-mcp] API: http://127.0.0.1:"+p+"  (/fleets /ships /equipment /resources /quests /airbase /basic /all)");',
+    '});',
+    '})()'
+  ].join('\n')
+}
+
+// ─── MCP Protocol ────────────────────────────────────────────────────────────
+
+// Minimum viable MCP stdio server — no external dependencies
+
+const JSONRPC_VERSION = '2.0'
+let reqId = 0
+
+function send(id, result, error) {
+  const msg = { jsonrpc: JSONRPC_VERSION }
+  if (id != null) msg.id = id
+  if (error) msg.error = { code: error.code || -32603, message: error.message }
+  else msg.result = result
+  process.stdout.write(JSON.stringify(msg) + '\n')
+}
+
+function sendLog(text) {
+  console.error('[poi-mcp] ' + text)
+}
+
+// ─── Main ────────────────────────────────────────────────────────────────────
+
+async function main() {
+  sendLog('POI MCP Server v0.1.0')
+  sendLog('Checking POI data API...')
+
+  const port = getPoiPort()
+  if (!port) {
+    sendLog('NOT CONNECTED — POI DevTools script not running')
+    sendLog('')
+    sendLog('=== 请在 POI 中执行以下步骤 ===')
+    sendLog('1. 启动 POI，进入游戏母港')
+    sendLog('2. 按 F12 打开 DevTools → Console 标签')
+    sendLog('3. 粘贴下面一整段脚本，按回车:')
+    sendLog('')
+    console.error(getInjectScript())
+    sendLog('')
+    sendLog('4. 关闭 DevTools，重新运行本命令')
+    process.exit(1)
+  }
+
+  // Verify the API is responding
+  try {
+    const health = await fetchFromPoi('/health')
+    sendLog(`Connected to POI API on port ${port}: ${health.status}`)
+  } catch (err) {
+    sendLog(`ERROR: POI API on port ${port} is not responding: ${err.message}`)
+    sendLog('Make sure POI is running and the script was pasted into DevTools Console.')
+    process.exit(1)
+  }
+
+  // ── MCP Request Handler ──────────────────────────────────────────────
+
+  const toolHandlers = {
+    get_fleet_status: async (args) => {
+      const fleets = await fetchFromPoi('/fleets')
+      if (!Array.isArray(fleets)) return { error: 'No fleet data' }
+      const fleet = fleets[args.fleetId - 1]
+      if (!fleet) return { error: `Fleet #${args.fleetId} not found` }
+
+      // Enrich with ship names and equipment
+      const ships = await fetchFromPoi('/ships')
+      const equips = await fetchFromPoi('/equipment')
+      return {
+        id: fleet.api_id,
+        name: fleet.api_name,
+        mission: fleet.api_mission,
+        ships: (fleet.api_ship || []).filter(id => id > 0).map(sid => {
+          const s = ships[sid]
+          if (!s) return { id: sid }
+          return {
+            id: s.api_id,
+            shipId: s.api_ship_id,
+            level: s.api_lv,
+            hp: `${s.api_nowhp}/${s.api_maxhp}`,
+            morale: s.api_cond,
+            locked: s.api_locked,
+            slotItems: (s.api_slot || []).filter(eid => eid > 0).map(eid => {
+              const e = equips[eid]
+              return e ? { equipId: e.api_slotitem_id, level: e.api_level || 0, prof: e.api_alv || 0 } : null
+            }).filter(Boolean)
+          }
+        })
+      }
+    },
+
+    search_ships: async (args) => {
+      const ships = await fetchFromPoi('/ships')
+      const results = Object.values(ships).filter(s => {
+        if (!s) return false
+        if (args.minLevel != null && s.api_lv < args.minLevel) return false
+        if (args.maxLevel != null && s.api_lv > args.maxLevel) return false
+        if (args.minMorale != null && s.api_cond < args.minMorale) return false
+        return true
+      })
+      return { total: results.length, ships: results }
+    },
+
+    search_equipment: async (args) => {
+      const equips = await fetchFromPoi('/equipment')
+      const results = Object.values(equips).filter(e => {
+        if (!e) return false
+        if (args.minLevel != null && (e.api_level || 0) < args.minLevel) return false
+        return true
+      })
+      return { total: results.length, equipment: results }
+    },
+
+    get_resources: async () => {
+      return await fetchFromPoi('/resources')
+    },
+
+    get_all: async () => {
+      return await fetchFromPoi('/all')
+    }
+  }
+
+  const resourceUris = [
+    'poi://fleets', 'poi://ships', 'poi://equipment',
+    'poi://resources', 'poi://quests', 'poi://airbase', 'poi://basic', 'poi://all'
+  ]
+
+  // ── JSON-RPC over stdio ──────────────────────────────────────────────
+
+  let buffer = ''
+  process.stdin.setEncoding('utf8')
+  process.stdin.on('data', async (chunk) => {
+    buffer += chunk
+    const lines = buffer.split('\n')
+    buffer = lines.pop() || ''
+    for (const line of lines) {
+      if (!line.trim()) continue
+      try {
+        const req = JSON.parse(line)
+        const { id, method, params } = req
+
+        switch (method) {
+          case 'initialize':
+            send(id, {
+              protocolVersion: '2024-11-05',
+              capabilities: {
+                resources: { subscribe: false },
+                tools: {}
+              },
+              serverInfo: { name: 'poi-mcp', version: '0.1.0' }
+            })
+            break
+
+          case 'notifications/initialized':
+          case 'notifications/cancelled':
+            break
+
+          case 'ping':
+            send(id, {})
+            break
+
+          case 'resources/list':
+            send(id, {
+              resources: resourceUris.map(uri => ({
+                uri, name: uri.replace('poi://', ''), mimeType: 'application/json'
+              }))
+            })
+            break
+
+          case 'resources/read': {
+            const uri = params?.uri
+            const endpoint = '/' + uri.replace('poi://', '')
+            const data = await fetchFromPoi(endpoint)
+            send(id, {
+              contents: [{
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(data, null, 2)
+              }]
+            })
+            break
+          }
+
+          case 'tools/list':
+            send(id, {
+              tools: [
+                {
+                  name: 'get_fleet_status',
+                  description: '获取舰队详细编成',
+                  inputSchema: {
+                    type: 'object',
+                    properties: { fleetId: { type: 'number', description: '舰队编号 1-4' } },
+                    required: ['fleetId']
+                  }
+                },
+                {
+                  name: 'search_ships',
+                  description: '搜索舰娘',
+                  inputSchema: {
+                    type: 'object',
+                    properties: {
+                      minLevel: { type: 'number' },
+                      maxLevel: { type: 'number' },
+                      minMorale: { type: 'number', description: '最低士气(闪)' }
+                    }
+                  }
+                },
+                {
+                  name: 'search_equipment',
+                  description: '搜索装备',
+                  inputSchema: {
+                    type: 'object',
+                    properties: {
+                      minLevel: { type: 'number', description: '最低改修★' }
+                    }
+                  }
+                },
+                {
+                  name: 'get_resources',
+                  description: '获取资源概况',
+                  inputSchema: { type: 'object', properties: {} }
+                },
+                {
+                  name: 'get_all',
+                  description: '获取所有数据（舰队/舰娘/装备/资源/任务/陆航）',
+                  inputSchema: { type: 'object', properties: {} }
+                }
+              ]
+            })
+            break
+
+          case 'tools/call': {
+            const toolName = params?.name
+            const toolArgs = params?.arguments || {}
+            const handler = toolHandlers[toolName]
+            if (handler) {
+              const result = await handler(toolArgs)
+              send(id, { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] })
+            } else {
+              send(id, null, { code: -32602, message: `Unknown tool: ${toolName}` })
+            }
+            break
+          }
+
+          default:
+            send(id, null, { code: -32601, message: `Unknown method: ${method}` })
+        }
+      } catch (err) {
+        // Malformed JSON — ignore
+      }
+    }
+  })
+
+  process.stdin.on('end', () => process.exit(0))
+  process.on('SIGINT', () => process.exit(0))
+  process.on('SIGTERM', () => process.exit(0))
+}
+
+main().catch(err => {
+  console.error('[poi-mcp] Fatal:', err.message)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "poi-plugin-mcp",
+  "version": "0.2.0",
+  "description": "Poi data bridge for local KanColle inventory tools.",
+  "main": "index.js",
+  "keywords": [
+    "poi-plugin",
+    "kancolle",
+    "mcp"
+  ],
+  "files": [
+    "index.js",
+    "lib",
+    "mcp-server.js",
+    "README.md"
+  ],
+  "bin": {
+    "poi-mcp": "mcp-server.js"
+  },
+  "scripts": {
+    "start": "node mcp-server.js",
+    "test": "node --test test/*.test.js"
+  },
+  "poiPlugin": {
+    "title": "MCP 数据桥",
+    "id": "mcp_data_bridge",
+    "description": "Expose Poi fleet, equipment, master, event tag, and planner data on local HTTP for CLI/MCP agents.",
+    "icon": "fa/database",
+    "priority": 53
+  },
+  "license": "MIT"
+}