taiwan-data-mcp 0.8.0 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taiwan-data-mcp",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "MCP server for Taiwan public data — 實價登錄、公司登記查核、165 防詐、藥品查詢、政府標案、農產行情。Query real Taiwan data from Claude, Cursor, etc.",
   "type": "module",
   "bin": {

package/src/server.mjs

@@ -4,7 +4,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import {
   scamCheck, companySearch, companyProfile, personCompanies, companyRisk,
-  companyRelations, companyNameCheck, companyVerify,
+  companyRelations, companyNameCheck, companyVerify, validateTaxId, findConnection,
   realpriceSearch, realpriceLocate, realpriceArea, realpriceEstimate, realpriceRoad,
   drugSearch, drugInfo,
   tenderByCompany, tenderSearch,
@@ -102,6 +102,31 @@ const TOOLS = [
     },
     run: (a) => companyVerify(a.unified_business_no),
   },
+  {
+    name: 'taiwan_validate_tax_id',
+    description:
+      '驗證台灣統一編號（8 碼）檢查碼是否正確（財政部統編邏輯，純演算法、不查資料庫）。資料清理、表單驗證、判斷一組號碼是否為有效統編格式用。回傳 valid 與說明。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: { unified_business_no: { type: 'string', description: '8 位統一編號，例如 22099131' } },
+      required: ['unified_business_no'],
+    },
+    run: (a) => validateTaxId(a.unified_business_no),
+  },
+  {
+    name: 'taiwan_find_connection',
+    description:
+      '查兩家公司／兩個人之間的最短關係鏈（天眼查式盡職調查）：透過共同負責人／董監事一層層串接，回傳中間的人與公司節點與相隔層數。用於「這兩家公司／這兩個人有沒有關係、怎麼牽上線」。a、b 可填公司名、8 位統編或人名。資料來源：inc.com.tw。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        a: { type: 'string', description: '起點：公司名／統編／人名，例如「鴻海精密工業」' },
+        b: { type: 'string', description: '終點：公司名／統編／人名，例如「三創數位」' },
+      },
+      required: ['a', 'b'],
+    },
+    run: (a) => findConnection(a.a, a.b),
+  },
   {
     name: 'taiwan_realprice_search',
     description:
@@ -237,7 +262,7 @@ const TOOLS = [
 ];
 
 const server = new Server(
-  { name: 'taiwan-data-mcp', version: '0.8.0' },
+  { name: 'taiwan-data-mcp', version: '0.10.0' },
   { capabilities: { tools: {} } }
 );
 
@@ -258,4 +283,4 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error('taiwan-data-mcp running (stdio) — 18 tools: 防詐 / 公司登記·關係·盡調 / 實價登錄 / 藥品健康 / 政府標案 / 農產行情');
+console.error('taiwan-data-mcp running (stdio) — 20 tools: 防詐 / 公司登記·關係·盡調 / 實價登錄 / 藥品健康 / 政府標案 / 農產行情');

package/src/sources.mjs

@@ -95,12 +95,13 @@ export async function companyRisk(idOrName) {
   if (f.reject) redFlags.push('政府採購拒絕往來');
   if (f.sanction) redFlags.push(`命中國際制裁名單 ${f.sanction} 筆（OFAC/UN 等）`);
   if (f.fsc) redFlags.push(`金管會重大裁罰 ${f.fsc} 件`);
-  if (f.judicial) redFlags.push(`司法案件 ${f.judicial} 筆`);
+  if (f.judicial) redFlags.push(`司法案件 ${f.judicial} 筆（以名稱比對，含一般民事/被列名，未必為違法，僅供參考）`);
   if (f.labor) redFlags.push(`勞動法令裁罰 ${f.labor} 筆`);
   if (f.env) redFlags.push(`環保裁罰 ${f.env} 筆`);
-  // 重大紅旗（解散/拒往/制裁/司法/金管）→ high；僅勞動或環保 → medium；皆無 → low
-  const major = f.dissolved || f.reject || f.sanction || f.judicial || f.fsc;
-  const level = major ? 'high' : (f.labor || f.env) ? 'medium' : 'low';
+  // 重大紅旗（解散／拒絕往來／國際制裁／金管會重大裁罰）→ high。
+  // 司法案件以名稱比對且噪訊高（大公司常被列為當事人），與勞動／環保同列 medium，不單獨拉到 high。
+  const major = f.dissolved || f.reject || f.sanction || f.fsc;
+  const level = major ? 'high' : (f.judicial || f.labor || f.env) ? 'medium' : 'low';
   return {
     unified_business_no: body.id,
     name: body.name,
@@ -157,6 +158,24 @@ export async function companyVerify(id) {
     source: body.src || '經濟部商工登記公示資料' };
 }
 
+// 統一編號檢查碼驗證（純演算法，資料清理／表單檢核用）。
+export async function validateTaxId(id) {
+  const tin = String(id || '').replace(/\D/g, '');
+  if (tin.length !== 8) return { input: String(id || ''), valid: false, reason: '統一編號必須是 8 位數字' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/taxid?id=${tin}`, { timeout: 10000 });
+  if (!ok || !body) return { input: tin, valid: false, reason: '查詢失敗（inc.com.tw）' };
+  return body;
+}
+
+// 關係路徑：兩家公司／兩人之間透過共同負責人／董監事串接的最短關係鏈（天眼查式盡調）。
+export async function findConnection(a, b) {
+  const qa = String(a || '').trim(), qb = String(b || '').trim();
+  if (!qa || !qb) return { error: '請提供 a 與 b（公司名／統編／人名）' };
+  const { ok, body } = await fetchJson(`https://inc.com.tw/api/path?a=${encodeURIComponent(qa)}&b=${encodeURIComponent(qb)}`, { timeout: 25000 });
+  if (!ok || !body) return { error: '查詢失敗（inc.com.tw）', a: qa, b: qb };
+  return body; // 已自帶 from/to/path/note/source
+}
+
 // ── 農產批發行情 MOA（農業部農產品交易行情）──────────────────────
 function _rocToAd(s) {
   const m = String(s || '').match(/^(\d{2,3})\.(\d{2})\.(\d{2})$/);