用途
japan-company-info-mcp-bridge 是一个面向日本企业尽职调查的 MCP（Model Context Protocol）服务器，主打 100% 离线运行。它把四个日本官方数据源整合到同一个检索层中，供 AI 助手在本地查询日本企业的注册信息、法定财报、股东结构与行业基准。官方描述强调“Zero cloud leakage. Zero Docker.”，即查询在用户机器上完成，不经过第三方 API。
主要能力
服务器暴露五个领域工具，并统一归一化为精确查询，另有一个通用回退工具：
edinet_financials_usgaap(company_name, metric?, fiscal_year?)：查询 EDINET 法定财务报表（损益表、资产负债表、现金流量表）及高管薪酬，会计概念在 J-GAAP / US GAAP / IFRS 之间映射。japan_corporate_registry(company_name, info_type?)：查询 13 位国税厅法人编号、注册地址、法律状态，以及 gBizINFO 认证 / 补贴。japan_shareholders(company_name, top_n?)：从有价证券报告书的“大株主”部分提取主要股东与股权结构。japan_industry_benchmarks(industry, metric?)：通过 e-Stat 获取财务省法人企业统计调查的行业基准（营业利润率、经常利润率、自有资本比率、ROE）。japan_company_search(query, method?, top_k?)：关键词 / 模糊 / 语义搜索，用于目标公司未知或名称不明确时发现公司。search_knowledge(query, method?, top_k?)：原始知识库搜索（回退）。method 可选 auto（默认）、bm25（精确关键词）、trigram（模糊 / 标识符）、vector（语义）、hybrid（RRF 融合）。
五个领域工具内部都会解析为 search_knowledge，因此检索层与 .orb 数据胶囊保持通用。
内置 J-GAAP / US GAAP / IFRS 映射字典，官方特别指出它能正确区分 営業利益（Operating Income）与 経常利益（Ordinary Income，J-GAAP 特有概念），避免英文阅读日本披露文件时的误译。
使用方式
服务器捆绑 mcporb-runtime 二进制与预索引的 Orb（BM25 + trigram + 可选稠密向量检索）。检索在用户机器上运行。首次启动时，运行时会在后台下载查询嵌入模型（约 220MB）以启用语义向量方法；在下载完成之前以及之后永久离线状态下，bm25、trigram 和 auto 方法无需任何网络访问即可工作。
接入 Claude Desktop：在 claude_desktop_config.json 中添加该服务器。在包发布到 npm 之前，使用 GitHub 形式："args": ["-y", "github:dqj1998/japan-company-info-mcp-bridge"]。也可在 Settings → MCP → Add Server 中添加同一服务器（command 为 npx，args 同上）。支持从克隆仓库本地运行。
平台支持：bin/ 中捆绑运行时二进制（无需外部系统库，可在最小化 / 无头镜像上运行）： macOS Apple Silicon (arm64) — mcporb-runtime-darwin-arm64 Linux x86-64 — mcporb-runtime-linux-x64 Linux arm64 — mcporb-runtime-linux-arm64 Windows x64 — mcporb-runtime-win32-x64.exe 未捆绑：macOS Intel (x86-64)。index.js 会解析 mcporb-runtime-<platform>-<arch>，若找不到匹配二进制则给出明确提示并退出。
适用场景
官方列出的用例包括：跨境股权分析、KYB / 尽职调查实体核验、M&A 目标筛选，以及用英文阅读日本法定披露文件而不误译 営業利益 与 経常利益。
限制与数据说明
免费版仅索引 192 家蓝筹公司（EDINET 上市、日经 225 样本）。查询该集合之外的公司会返回最接近的可用匹配；完整数据集（3,193+ 上市公司，含完整 XBRL 财报、主要股东、gBizINFO 详情及财务省法人企业统计调查行业基准）需在 mcporb.store 一次性购买。
检索可靠性方面：按法人编号或证券代码（精确标识符）检索最可靠，其次是日文公司名；英文公司名搜索仅覆盖有官方英文名的公司（其余为尽力而为）。
数据来源与署名：法人番号公表サイト（国税厅）— 企业注册；EDINET（金融厅）— 有价证券报告书 XBRL 财报；gBizINFO（经济产业省）— 认证、补贴、表彰；財務省 法人企業統計調査 — 行业基准（完整版）。数据按各来源条款再分发，详见 NOTICE。桥接代码为 MIT 许可（见 LICENSE）；捆绑的 Orb 数据与 mcporb-runtime 二进制不是 MIT，单独授权，详见 NOTICE。
