Metadata-Version: 2.4
Name: japan-corporate-mcp
Version: 0.1.0
Summary: MCP Server for Japanese corporate data - search companies, financials, patents, subsidies via government APIs
Project-URL: Homepage, https://github.com/drago/japan-corporate-mcp
Project-URL: Repository, https://github.com/drago/japan-corporate-mcp
Project-URL: Issues, https://github.com/drago/japan-corporate-mcp/issues
Author: drago
License-Expression: MIT
License-File: LICENSE
Keywords: corporate,edinet,enterprise,estat,finance,gbizinfo,japan,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.2.0
Description-Content-Type: text/markdown

# 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
