Japan Corporate MCP

1# japan-corporate-mcp
2 
3MCP Server for Japanese corporate data — search companies, financials, patents, subsidies, and government statistics via official government APIs.
4 
5日本企業データMCPサーバー — gBizINFO・EDINET・e-Statの政府APIから企業情報をAIが直接取得できます。
6 
7## Features / 機能
8 
9| Tool | Description | データソース |
10|------|-------------|-------------|
11| `search_company` | Search companies by name | gBizINFO |
12| `get_company_info` | Company details (address, capital, employees) | gBizINFO |
13| `get_company_finance` | Financial data (revenue, profit, assets) | gBizINFO |
14| `get_company_patents` | Patent information | gBizINFO |
15| `get_company_subsidies` | Subsidies and grants received | gBizINFO |
16| `get_company_procurement` | Government procurement records | gBizINFO |
17| `get_edinet_reports` | Securities reports (有価証券報告書) | EDINET |
18| `get_statistics` | Government statistics search | e-Stat |
19 
20## Installation / インストール
21 
22```bash
23pip install japan-corporate-mcp
24```
25 
26## API Key Setup / APIキーの取得
27 
28You need API keys from the following government services:
29 
30| API | Registration | URL |
31|-----|-------------|-----|
32| **gBizINFO** (経産省) | Web registration, instant | https://info.gbiz.go.jp/hojin/api_registration |
33| **EDINET** (金融庁) | Web registration + MFA | https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WZEK0110.html |
34| **e-Stat** (総務省) | Web registration, instant | https://www.e-stat.go.jp/api/ |
35 
36## Configuration / 設定
37 
38### Claude Desktop
39 
40Add to your `claude_desktop_config.json`:
41 
42```json
43{
44  "mcpServers": {
45    "japan-corporate": {
46      "command": "japan-corporate-mcp",
47      "env": {
48        "GBIZINFO_API_TOKEN": "your-gbizinfo-token",
49        "EDINET_SUBSCRIPTION_KEY": "your-edinet-key",
50        "ESTAT_APP_ID": "your-estat-app-id"
51      }
52    }
53  }
54}
55```
56 
57### Claude Code
58 
59```bash
60claude mcp add japan-corporate -- japan-corporate-mcp \
61  -e GBIZINFO_API_TOKEN=your-token \
62  -e EDINET_SUBSCRIPTION_KEY=your-key \
63  -e ESTAT_APP_ID=your-app-id
64```
65 
66### Cursor
67 
68Add to `.cursor/mcp.json`:
69 
70```json
71{
72  "mcpServers": {
73    "japan-corporate": {
74      "command": "japan-corporate-mcp",
75      "env": {
76        "GBIZINFO_API_TOKEN": "your-gbizinfo-token",
77        "EDINET_SUBSCRIPTION_KEY": "your-edinet-key",
78        "ESTAT_APP_ID": "your-estat-app-id"
79      }
80    }
81  }
82}
83```
84 
85## Usage Examples / 使用例
86 
87Once configured, you can ask your AI assistant:
88 
89- "ソニーグループの企業情報を教えて" (Get Sony Group's company info)
90- "トヨタ自動車の特許情報を検索して" (Search Toyota's patents)
91- "東京都のAI関連企業を探して" (Find AI companies in Tokyo)
92- "日本の製造業に関する統計データを検索" (Search manufacturing statistics)
93- "最近のEDINET報告書でソフトバンクを検索" (Search SoftBank's EDINET filings)
94 
95## Environment Variables / 環境変数
96 
97| Variable | Required | Description |
98|----------|----------|-------------|
99| `GBIZINFO_API_TOKEN` | Yes* | gBizINFO API token |
100| `EDINET_SUBSCRIPTION_KEY` | For EDINET tools | EDINET subscription key |
101| `ESTAT_APP_ID` | For e-Stat tools | e-Stat application ID |
102 
103\* At minimum, `GBIZINFO_API_TOKEN` is needed for company search/info tools.
104 
105## Development / 開発
106 
107```bash
108git clone https://github.com/drago/japan-corporate-mcp.git
109cd japan-corporate-mcp
110pip install -e ".[dev]"
111pytest
112```
113 
114## License
115 
116MIT
117