Content
# japan-corporate-mcp
MCP Server for Japanese corporate data — search companies, financials, patents, subsidies, and government statistics via official government APIs.
日本企業データMCPサーバー — gBizINFO・EDINET・e-Statの政府APIから企業情報をAIが直接取得できます。
## Features / 機能
| Tool | Description | データソース |
|------|-------------|-------------|
| `search_company` | Search companies by name | gBizINFO |
| `get_company_info` | Company details (address, capital, employees) | gBizINFO |
| `get_company_finance` | Financial data (revenue, profit, assets) | gBizINFO |
| `get_company_patents` | Patent information | gBizINFO |
| `get_company_subsidies` | Subsidies and grants received | gBizINFO |
| `get_company_procurement` | Government procurement records | gBizINFO |
| `get_edinet_reports` | Securities reports (有価証券報告書) | EDINET |
| `get_statistics` | Government statistics search | e-Stat |
## Installation / インストール
```bash
pip install japan-corporate-mcp
```
## API Key Setup / APIキーの取得
You need API keys from the following government services:
| API | Registration | URL |
|-----|-------------|-----|
| **gBizINFO** (経産省) | Web registration, instant | https://info.gbiz.go.jp/hojin/api_registration |
| **EDINET** (金融庁) | Web registration + MFA | https://disclosure2dl.edinet-fsa.go.jp/guide/static/disclosure/WZEK0110.html |
| **e-Stat** (総務省) | Web registration, instant | https://www.e-stat.go.jp/api/ |
## Configuration / 設定
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"japan-corporate": {
"command": "japan-corporate-mcp",
"env": {
"GBIZINFO_API_TOKEN": "your-gbizinfo-token",
"EDINET_SUBSCRIPTION_KEY": "your-edinet-key",
"ESTAT_APP_ID": "your-estat-app-id"
}
}
}
}
```
### Claude Code
```bash
claude mcp add japan-corporate -- japan-corporate-mcp \
-e GBIZINFO_API_TOKEN=your-token \
-e EDINET_SUBSCRIPTION_KEY=your-key \
-e ESTAT_APP_ID=your-app-id
```
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"japan-corporate": {
"command": "japan-corporate-mcp",
"env": {
"GBIZINFO_API_TOKEN": "your-gbizinfo-token",
"EDINET_SUBSCRIPTION_KEY": "your-edinet-key",
"ESTAT_APP_ID": "your-estat-app-id"
}
}
}
}
```
## Usage Examples / 使用例
Once configured, you can ask your AI assistant:
- "ソニーグループの企業情報を教えて" (Get Sony Group's company info)
- "トヨタ自動車の特許情報を検索して" (Search Toyota's patents)
- "東京都のAI関連企業を探して" (Find AI companies in Tokyo)
- "日本の製造業に関する統計データを検索" (Search manufacturing statistics)
- "最近のEDINET報告書でソフトバンクを検索" (Search SoftBank's EDINET filings)
## Environment Variables / 環境変数
| Variable | Required | Description |
|----------|----------|-------------|
| `GBIZINFO_API_TOKEN` | Yes* | gBizINFO API token |
| `EDINET_SUBSCRIPTION_KEY` | For EDINET tools | EDINET subscription key |
| `ESTAT_APP_ID` | For e-Stat tools | e-Stat application ID |
\* At minimum, `GBIZINFO_API_TOKEN` is needed for company search/info tools.
## Development / 開発
```bash
git clone https://github.com/drago/japan-corporate-mcp.git
cd japan-corporate-mcp
pip install -e ".[dev]"
pytest
```
## License
MIT
