io.github.dqj1998/japan-company-info-mcp-bridge
Offline MCP for verified Japanese corporate data: EDINET XBRL financials, NTA IDs, gBizINFO.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
japan-company-info-mcp-bridgeclaude mcp add japan-company-info-mcp-bridge -- npx -y japan-company-info-mcp-bridge@1.2.3
{
"mcpServers": {
"japan-company-info-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"japan-company-info-mcp-bridge@1.2.3"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Japan Company Info — MCP Server (Free Edition)
The only 100% OFFLINE, all-in-one Japanese Corporate Due Diligence MCP. Integrates 4 official government sources: NTA 13-digit Corporate IDs, EDINET XBRL financials (US GAAP / IFRS mapped), e-Stat industry benchmarks, and gBizINFO certifications. Zero cloud leakage. Zero Docker.
Query EDINET statutory filings (5-year XBRL), National Tax Agency 13-digit corporate numbers, major shareholders, and gBizINFO certifications/subsidies — with a built-in J-GAAP / US GAAP / IFRS mapping dictionary that correctly distinguishes 営業利益 (Operating Income) from 経常利益 (Ordinary Income, a J-GAAP-only concept).
This package is the Free edition: 192 large-cap blue-chip listed companies (EDINET-listed, Nikkei 225 sample). The full dataset — 3,193+ listed companies with complete XBRL financials, major shareholders, gBizINFO details, and 財務省 法人企業統計調査 industry benchmarks — is available as a one-time purchase at mcporb.store.
Use cases: cross-border equity analysis, KYB / due-diligence entity verification, M&A target screening, and reading Japanese filings in English without mistranslating 営業利益 (Operating Income) vs 経常利益 (Ordinary Income, a J-GAAP-only concept).
How it works
The server bundles the mcporb-runtime binary and a pre-indexed Orb (BM25 + trigram +
optional dense-vector retrieval). Retrieval runs on your machine. On first launch the
runtime downloads its query-embedding model (~220MB) in the background to enable the
semantic vector method; until that finishes — and forever after, offline — the bm25,
trigram, and auto methods work without any network access. Your queries are not sent to
a third-party API by this server.
It exposes five domain tools that normalize your request into a precise query, plus the
generic search_knowledge tool as a fallback for open-ended questions:
edinet_financials_usgaap(company_name, metric?, fiscal_year?)— EDINET statutory financials (P/L, balance sheet, cash flow) and executive compensation, with accounting concepts mapped across J-GAAP / US GAAP / IFRS.japan_corporate_registry(company_name, info_type?)— 13-digit National Tax Agency corporate number, registered address, legal status, and gBizINFO certifications / subsidies.japan_shareholders(company_name, top_n?)— major shareholders and ownership structure from the 大株主 section of 有価証券報告書.japan_industry_benchmarks(industry, metric?)— sector benchmarks (operating margin, ordinary margin, equity ratio, ROE) from 財務省 法人企業統計調査 via e-Stat.japan_company_search(query, method?, top_k?)— keyword / fuzzy / semantic search to discover a company when the target is unknown or ambiguous.search_knowledge(query, method?, top_k?)— raw knowledge-base search (fallback).method∈auto(default) ·bm25(exact keyword) ·trigram(fuzzy / identifier) ·vector(semantic) ·hybrid(RRF fusion).
The five domain tools resolve into search_knowledge internally, so retrieval and the
.orb capsule stay completely generic.
Quick start
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"japan-company-info": {
"command": "npx",
"args": ["-y", "japan-company-info-mcp-bridge"]
}
}
}
(Before the package is published to npm, use the GitHub form:
"args": ["-y", "github:dqj1998/japan-company-info-mcp-bridge"].)
Cursor
Add the same server under Settings → MCP → Add Server (command npx, args as above).
Local (from a clone)
npx .
Platform support
Bundled runtime binaries in bin/ (no external system libraries required — run on minimal/headless images):
- 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
Not bundled: macOS Intel (x86-64). index.js resolves mcporb-runtime-<platform>-<arch> and exits
with a clear message if no matching binary is found.
Example queries
Most reliable retrieval is by corporate number or securities code (exact identifiers), then Japanese company name; English company-name search covers companies with an official English name (best-effort otherwise).
| Intent | Example |
|---|---|
| By corporate number | search_knowledge("1180301018771") → Toyota Motor Corporation |
| By securities code | search_knowledge("72030", method="trigram") → Toyota Motor Corporation |
| By Japanese name | search_knowledge("トヨタ自動車", method="hybrid") |
| GAAP concept | search_knowledge("経常利益はUS GAAPでどう表現するか") |
Coverage note: this Free edition indexes 192 blue-chip companies. Queries for companies outside that set return the closest available matches; unlock the full 3,193+ company dataset at mcporb.store.
Data sources & attribution
- 法人番号公表サイト (National Tax Agency) — corporate registration
- EDINET (Financial Services Agency) — 有価証券報告書 XBRL financials
- gBizINFO (METI) — certifications, subsidies, commendations
- 財務省 法人企業統計調査 — industry benchmarks (full edition)
Data is redistributed under each source's terms; see NOTICE.
License
Bridge code is MIT (see LICENSE). The bundled Orb data and mcporb-runtime
binary are not MIT — they are licensed separately; see NOTICE.
Keywords: MCP · EDINET · Japanese GAAP · US GAAP · IFRS · Operating Income · Ordinary Income · Balance Sheet · Statutory Audit · Corporate Number · National Tax Agency · Due Diligence · Entity Verification · AML · KYB · gBizINFO · JSIC · Operating Margin · Industry Benchmark · Credit Risk
الأسئلة الشائعة
ما هو io.github.dqj1998/japan-company-info-mcp-bridge؟
Offline MCP for verified Japanese corporate data: EDINET XBRL financials, NTA IDs, gBizINFO.
كيف أثبّت io.github.dqj1998/japan-company-info-mcp-bridge؟
يعمل على جهازك. في Claude Code: claude mcp add japan-company-info-mcp-bridge -- npx -y japan-company-info-mcp-bridge@1.2.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.dqj1998/japan-company-info-mcp-bridge إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.github.dqj1998/japan-company-info-mcp-bridge مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.dqj1998/japan-company-info-mcp-bridge؟
ينشره dqj1998. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.