Back to Directory/Developer Tools

io.github.dqj1998/japan-company-info-mcp-bridge

Offline MCP for verified Japanese corporate data: EDINET XBRL financials, NTA IDs, gBizINFO.

Developer ToolsJavaScriptv1.2.3

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).

IntentExample
By corporate numbersearch_knowledge("1180301018771") → Toyota Motor Corporation
By securities codesearch_knowledge("72030", method="trigram") → Toyota Motor Corporation
By Japanese namesearch_knowledge("トヨタ自動車", method="hybrid")
GAAP conceptsearch_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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y japan-company-info-mcp-bridge

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-dqj1998-japan-company-info-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "japan-company-info-mcp-bridge"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

japan-company-info-mcp-bridgenpm

Compatible MCP Clients

io.github.dqj1998/japan-company-info-mcp-bridge works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More