# FSC Corporate Financial Information MCP Server
# 금융위원회 기업 재무정보 MCP 서버
한국 금융위원회의 기업 재무정보 API를 MCP(Model Context Protocol) 서버로 제공합니다.
An MCP server providing access to Korea Financial Services Commission's corporate financial information API.
## Features / 기능
- 📊 **Summary Financial Statements** (요약 재무제표): Revenue, profit, assets, liabilities
- 📋 **Balance Sheet** (재무상태표): Detailed asset and liability accounts
- 💹 **Income Statement** (손익계산서): Revenue and expense accounts
- 🔍 **Comprehensive Search** (통합 조회): All financial data in one request
## Installation / 설치
### From PyPI / PyPI에서 설치
```bash
pip install data-go-mcp.fsc-financial-info
```
### From Source / 소스에서 설치
```bash
cd src/fsc-financial-info
uv sync
```
## Configuration / 설정
### Claude Desktop Configuration
Add to your Claude Desktop configuration file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"fsc-financial-info": {
"command": "uvx",
"args": ["data-go-mcp.fsc-financial-info@latest"],
"env": {
"FSC_FINANCIAL_INFO_API_KEY": "your-api-key-here"
}
}
}
}
```
## API Key / API 키 발급
1. Visit [data.go.kr](https://www.data.go.kr)
2. Sign up for an account
3. Search for "금융위원회_기업 재무정보"
4. Request API access
5. Get your service key
## Available Tools / 사용 가능한 도구
### 1. `get_summary_financial_statement`
Get summary financial statements including key financial metrics.
**Parameters:**
- `crno` (optional): Corporate registration number (13 digits)
- `biz_year` (optional): Business year (e.g., "2023")
- `page_no` (optional): Page number (default: 1)
- `num_of_rows` (optional): Rows per page (default: 10, max: 100)
**Example:**
```
"법인등록번호 1101111848914의 2023년 요약 재무제표를 조회해줘"
```
### 2. `get_balance_sheet`
Get detailed balance sheet with asset, liability, and equity accounts.
**Parameters:**
- `crno` (optional): Corporate registration number
- `biz_year` (optional): Business year
- `page_no` (optional): Page number
- `num_of_rows` (optional): Rows per page
**Example:**
```
"법인번호 1101111848914의 2023년 재무상태표를 보여줘"
```
### 3. `get_income_statement`
Get income statement with revenue, expense, and profit accounts.
**Parameters:**
- `crno` (optional): Corporate registration number
- `biz_year` (optional): Business year
- `page_no` (optional): Page number
- `num_of_rows` (optional): Rows per page
**Example:**
```
"1101111848914 법인의 2023년 손익계산서 조회"
```
### 4. `search_company_financial_info`
Get comprehensive financial information including all three statements.
**Parameters:**
- `crno` (required): Corporate registration number
- `biz_year` (required): Business year
**Example:**
```
"법인등록번호 1101111848914의 2023년 전체 재무정보를 통합 조회해줘"
```
## Response Format / 응답 형식
### Summary Financial Statement
```
📊 요약 재무제표 조회 결과 (총 1건)
==================================================
법인등록번호: 1101111848914
사업연도: 2023
기준일자: 20231231
재무제표구분: 연결요약재무제표
통화: KRW
💰 주요 재무지표:
• 매출액: 1,000.00억원
• 영업이익: 100.00억원
• 당기순이익: 50.00억원
• 총자산: 2,000.00억원
• 총부채: 800.00억원
• 총자본: 1,200.00억원
• 자본금: 100.00억원
• 부채비율: 66.67%
```
### Balance Sheet
```
📋 재무상태표 조회 결과 (총 18건)
==================================================
법인등록번호: 1101111848914
사업연도: 2023
기준일자: 20231231
재무제표구분: 연결재무제표
📊 계정과목별 금액:
[자산총계]
• 당기: 2,000.00억원
• 전기: 1,800.00억원
• 증감: 200.00억원 (+11.1%)
[부채총계]
• 당기: 800.00억원
• 전기: 900.00억원
• 증감: -100.00억원 (-11.1%)
```
## Usage Examples / 사용 예시
### Basic Query
```python
# Through Claude Desktop
"삼성전자의 2023년 재무제표를 보여줘"
"법인번호 1301110006246의 최근 재무상태를 알려줘"
```
### Comparative Analysis
```python
"법인번호 1101111848914의 2022년과 2023년 매출액 비교"
"이 회사의 부채비율 변화를 확인해줘"
```
### Comprehensive Review
```python
"법인번호 1101111848914의 2023년 전체 재무정보를 분석해줘"
"이 회사의 재무건전성을 평가해줘"
```
## Error Handling / 오류 처리
The server handles various error conditions:
- **No API Key**: "FSC_FINANCIAL_INFO_API_KEY environment variable is not set"
- **Invalid Corporate Registration Number**: "법인등록번호는 13자리 숫자여야 합니다"
- **Invalid Year**: "유효한 연도를 입력해주세요"
- **No Data Found**: "조회된 재무제표가 없습니다"
- **API Errors**: Detailed error codes and messages
## Financial Metrics / 재무 지표
### Key Metrics Provided
1. **Revenue Metrics** (수익 지표)
- 매출액 (Revenue)
- 영업이익 (Operating Profit)
- 당기순이익 (Net Income)
2. **Asset Metrics** (자산 지표)
- 총자산 (Total Assets)
- 유동자산 (Current Assets)
- 비유동자산 (Non-current Assets)
3. **Liability & Equity** (부채 및 자본)
- 총부채 (Total Liabilities)
- 총자본 (Total Equity)
- 자본금 (Paid-in Capital)
4. **Financial Ratios** (재무 비율)
- 부채비율 (Debt Ratio)
- 자기자본비율 (Equity Ratio)
## Development / 개발
### Running Tests
```bash
cd src/fsc-financial-info
uv run pytest tests/ -v
```
### Local Development
```bash
# Set environment variable
export FSC_FINANCIAL_INFO_API_KEY="your-api-key"
# Run server
uv run python -m data_go_mcp.fsc_financial_info.server
```
## API Rate Limits / API 제한
- **Max requests per second**: 30 TPS
- **Max rows per request**: 100
- **Data update frequency**: Daily
## Contributing / 기여
Contributions are welcome! Please see [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
## License / 라이선스
This project is licensed under the Apache License 2.0 - see the [LICENSE](../../LICENSE) file for details.
## Support / 지원
For issues or questions, please open an issue on [GitHub](https://github.com/Koomook/data-go-mcp-servers/issues).
Raw data
{
"_id": null,
"home_page": null,
"name": "data-go-mcp.fsc-financial-info",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "corporate, data.go.kr, financial, fsc, korea, llm, mcp, openapi",
"author": null,
"author_email": "Your Name <your.email@example.com>",
"download_url": "https://files.pythonhosted.org/packages/7d/5c/d313c8b5499db0bc83d43916780c2125aee1cbf7e00dc7b2bd666a6c50ae/data_go_mcp_fsc_financial_info-0.1.1.tar.gz",
"platform": null,
"description": "# FSC Corporate Financial Information MCP Server\n# \uae08\uc735\uc704\uc6d0\ud68c \uae30\uc5c5 \uc7ac\ubb34\uc815\ubcf4 MCP \uc11c\ubc84\n\n\ud55c\uad6d \uae08\uc735\uc704\uc6d0\ud68c\uc758 \uae30\uc5c5 \uc7ac\ubb34\uc815\ubcf4 API\ub97c MCP(Model Context Protocol) \uc11c\ubc84\ub85c \uc81c\uacf5\ud569\ub2c8\ub2e4.\n\nAn MCP server providing access to Korea Financial Services Commission's corporate financial information API.\n\n## Features / \uae30\ub2a5\n\n- \ud83d\udcca **Summary Financial Statements** (\uc694\uc57d \uc7ac\ubb34\uc81c\ud45c): Revenue, profit, assets, liabilities\n- \ud83d\udccb **Balance Sheet** (\uc7ac\ubb34\uc0c1\ud0dc\ud45c): Detailed asset and liability accounts \n- \ud83d\udcb9 **Income Statement** (\uc190\uc775\uacc4\uc0b0\uc11c): Revenue and expense accounts\n- \ud83d\udd0d **Comprehensive Search** (\ud1b5\ud569 \uc870\ud68c): All financial data in one request\n\n## Installation / \uc124\uce58\n\n### From PyPI / PyPI\uc5d0\uc11c \uc124\uce58\n\n```bash\npip install data-go-mcp.fsc-financial-info\n```\n\n### From Source / \uc18c\uc2a4\uc5d0\uc11c \uc124\uce58\n\n```bash\ncd src/fsc-financial-info\nuv sync\n```\n\n## Configuration / \uc124\uc815\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"fsc-financial-info\": {\n \"command\": \"uvx\",\n \"args\": [\"data-go-mcp.fsc-financial-info@latest\"],\n \"env\": {\n \"FSC_FINANCIAL_INFO_API_KEY\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n## API Key / API \ud0a4 \ubc1c\uae09\n\n1. Visit [data.go.kr](https://www.data.go.kr)\n2. Sign up for an account\n3. Search for \"\uae08\uc735\uc704\uc6d0\ud68c_\uae30\uc5c5 \uc7ac\ubb34\uc815\ubcf4\"\n4. Request API access\n5. Get your service key\n\n## Available Tools / \uc0ac\uc6a9 \uac00\ub2a5\ud55c \ub3c4\uad6c\n\n### 1. `get_summary_financial_statement`\nGet summary financial statements including key financial metrics.\n\n**Parameters:**\n- `crno` (optional): Corporate registration number (13 digits)\n- `biz_year` (optional): Business year (e.g., \"2023\")\n- `page_no` (optional): Page number (default: 1)\n- `num_of_rows` (optional): Rows per page (default: 10, max: 100)\n\n**Example:**\n```\n\"\ubc95\uc778\ub4f1\ub85d\ubc88\ud638 1101111848914\uc758 2023\ub144 \uc694\uc57d \uc7ac\ubb34\uc81c\ud45c\ub97c \uc870\ud68c\ud574\uc918\"\n```\n\n### 2. `get_balance_sheet`\nGet detailed balance sheet with asset, liability, and equity accounts.\n\n**Parameters:**\n- `crno` (optional): Corporate registration number\n- `biz_year` (optional): Business year\n- `page_no` (optional): Page number\n- `num_of_rows` (optional): Rows per page\n\n**Example:**\n```\n\"\ubc95\uc778\ubc88\ud638 1101111848914\uc758 2023\ub144 \uc7ac\ubb34\uc0c1\ud0dc\ud45c\ub97c \ubcf4\uc5ec\uc918\"\n```\n\n### 3. `get_income_statement`\nGet income statement with revenue, expense, and profit accounts.\n\n**Parameters:**\n- `crno` (optional): Corporate registration number\n- `biz_year` (optional): Business year\n- `page_no` (optional): Page number\n- `num_of_rows` (optional): Rows per page\n\n**Example:**\n```\n\"1101111848914 \ubc95\uc778\uc758 2023\ub144 \uc190\uc775\uacc4\uc0b0\uc11c \uc870\ud68c\"\n```\n\n### 4. `search_company_financial_info`\nGet comprehensive financial information including all three statements.\n\n**Parameters:**\n- `crno` (required): Corporate registration number\n- `biz_year` (required): Business year\n\n**Example:**\n```\n\"\ubc95\uc778\ub4f1\ub85d\ubc88\ud638 1101111848914\uc758 2023\ub144 \uc804\uccb4 \uc7ac\ubb34\uc815\ubcf4\ub97c \ud1b5\ud569 \uc870\ud68c\ud574\uc918\"\n```\n\n## Response Format / \uc751\ub2f5 \ud615\uc2dd\n\n### Summary Financial Statement\n```\n\ud83d\udcca \uc694\uc57d \uc7ac\ubb34\uc81c\ud45c \uc870\ud68c \uacb0\uacfc (\ucd1d 1\uac74)\n\n==================================================\n\ubc95\uc778\ub4f1\ub85d\ubc88\ud638: 1101111848914\n\uc0ac\uc5c5\uc5f0\ub3c4: 2023\n\uae30\uc900\uc77c\uc790: 20231231\n\uc7ac\ubb34\uc81c\ud45c\uad6c\ubd84: \uc5f0\uacb0\uc694\uc57d\uc7ac\ubb34\uc81c\ud45c\n\ud1b5\ud654: KRW\n\n\ud83d\udcb0 \uc8fc\uc694 \uc7ac\ubb34\uc9c0\ud45c:\n \u2022 \ub9e4\ucd9c\uc561: 1,000.00\uc5b5\uc6d0\n \u2022 \uc601\uc5c5\uc774\uc775: 100.00\uc5b5\uc6d0\n \u2022 \ub2f9\uae30\uc21c\uc774\uc775: 50.00\uc5b5\uc6d0\n \u2022 \ucd1d\uc790\uc0b0: 2,000.00\uc5b5\uc6d0\n \u2022 \ucd1d\ubd80\ucc44: 800.00\uc5b5\uc6d0\n \u2022 \ucd1d\uc790\ubcf8: 1,200.00\uc5b5\uc6d0\n \u2022 \uc790\ubcf8\uae08: 100.00\uc5b5\uc6d0\n \u2022 \ubd80\ucc44\ube44\uc728: 66.67%\n```\n\n### Balance Sheet\n```\n\ud83d\udccb \uc7ac\ubb34\uc0c1\ud0dc\ud45c \uc870\ud68c \uacb0\uacfc (\ucd1d 18\uac74)\n\n==================================================\n\ubc95\uc778\ub4f1\ub85d\ubc88\ud638: 1101111848914\n\uc0ac\uc5c5\uc5f0\ub3c4: 2023\n\uae30\uc900\uc77c\uc790: 20231231\n\uc7ac\ubb34\uc81c\ud45c\uad6c\ubd84: \uc5f0\uacb0\uc7ac\ubb34\uc81c\ud45c\n\n\ud83d\udcca \uacc4\uc815\uacfc\ubaa9\ubcc4 \uae08\uc561:\n\n [\uc790\uc0b0\ucd1d\uacc4]\n \u2022 \ub2f9\uae30: 2,000.00\uc5b5\uc6d0\n \u2022 \uc804\uae30: 1,800.00\uc5b5\uc6d0\n \u2022 \uc99d\uac10: 200.00\uc5b5\uc6d0 (+11.1%)\n\n [\ubd80\ucc44\ucd1d\uacc4]\n \u2022 \ub2f9\uae30: 800.00\uc5b5\uc6d0\n \u2022 \uc804\uae30: 900.00\uc5b5\uc6d0\n \u2022 \uc99d\uac10: -100.00\uc5b5\uc6d0 (-11.1%)\n```\n\n## Usage Examples / \uc0ac\uc6a9 \uc608\uc2dc\n\n### Basic Query\n```python\n# Through Claude Desktop\n\"\uc0bc\uc131\uc804\uc790\uc758 2023\ub144 \uc7ac\ubb34\uc81c\ud45c\ub97c \ubcf4\uc5ec\uc918\"\n\"\ubc95\uc778\ubc88\ud638 1301110006246\uc758 \ucd5c\uadfc \uc7ac\ubb34\uc0c1\ud0dc\ub97c \uc54c\ub824\uc918\"\n```\n\n### Comparative Analysis\n```python\n\"\ubc95\uc778\ubc88\ud638 1101111848914\uc758 2022\ub144\uacfc 2023\ub144 \ub9e4\ucd9c\uc561 \ube44\uad50\"\n\"\uc774 \ud68c\uc0ac\uc758 \ubd80\ucc44\ube44\uc728 \ubcc0\ud654\ub97c \ud655\uc778\ud574\uc918\"\n```\n\n### Comprehensive Review\n```python\n\"\ubc95\uc778\ubc88\ud638 1101111848914\uc758 2023\ub144 \uc804\uccb4 \uc7ac\ubb34\uc815\ubcf4\ub97c \ubd84\uc11d\ud574\uc918\"\n\"\uc774 \ud68c\uc0ac\uc758 \uc7ac\ubb34\uac74\uc804\uc131\uc744 \ud3c9\uac00\ud574\uc918\"\n```\n\n## Error Handling / \uc624\ub958 \ucc98\ub9ac\n\nThe server handles various error conditions:\n\n- **No API Key**: \"FSC_FINANCIAL_INFO_API_KEY environment variable is not set\"\n- **Invalid Corporate Registration Number**: \"\ubc95\uc778\ub4f1\ub85d\ubc88\ud638\ub294 13\uc790\ub9ac \uc22b\uc790\uc5ec\uc57c \ud569\ub2c8\ub2e4\"\n- **Invalid Year**: \"\uc720\ud6a8\ud55c \uc5f0\ub3c4\ub97c \uc785\ub825\ud574\uc8fc\uc138\uc694\"\n- **No Data Found**: \"\uc870\ud68c\ub41c \uc7ac\ubb34\uc81c\ud45c\uac00 \uc5c6\uc2b5\ub2c8\ub2e4\"\n- **API Errors**: Detailed error codes and messages\n\n## Financial Metrics / \uc7ac\ubb34 \uc9c0\ud45c\n\n### Key Metrics Provided\n\n1. **Revenue Metrics** (\uc218\uc775 \uc9c0\ud45c)\n - \ub9e4\ucd9c\uc561 (Revenue)\n - \uc601\uc5c5\uc774\uc775 (Operating Profit)\n - \ub2f9\uae30\uc21c\uc774\uc775 (Net Income)\n\n2. **Asset Metrics** (\uc790\uc0b0 \uc9c0\ud45c)\n - \ucd1d\uc790\uc0b0 (Total Assets)\n - \uc720\ub3d9\uc790\uc0b0 (Current Assets)\n - \ube44\uc720\ub3d9\uc790\uc0b0 (Non-current Assets)\n\n3. **Liability & Equity** (\ubd80\ucc44 \ubc0f \uc790\ubcf8)\n - \ucd1d\ubd80\ucc44 (Total Liabilities)\n - \ucd1d\uc790\ubcf8 (Total Equity)\n - \uc790\ubcf8\uae08 (Paid-in Capital)\n\n4. **Financial Ratios** (\uc7ac\ubb34 \ube44\uc728)\n - \ubd80\ucc44\ube44\uc728 (Debt Ratio)\n - \uc790\uae30\uc790\ubcf8\ube44\uc728 (Equity Ratio)\n\n## Development / \uac1c\ubc1c\n\n### Running Tests\n```bash\ncd src/fsc-financial-info\nuv run pytest tests/ -v\n```\n\n### Local Development\n```bash\n# Set environment variable\nexport FSC_FINANCIAL_INFO_API_KEY=\"your-api-key\"\n\n# Run server\nuv run python -m data_go_mcp.fsc_financial_info.server\n```\n\n## API Rate Limits / API \uc81c\ud55c\n\n- **Max requests per second**: 30 TPS\n- **Max rows per request**: 100\n- **Data update frequency**: Daily\n\n## Contributing / \uae30\uc5ec\n\nContributions are welcome! Please see [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.\n\n## License / \ub77c\uc774\uc120\uc2a4\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](../../LICENSE) file for details.\n\n## Support / \uc9c0\uc6d0\n\nFor issues or questions, please open an issue on [GitHub](https://github.com/Koomook/data-go-mcp-servers/issues).",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "MCP server for Korea FSC Corporate Financial Information API (\uae08\uc735\uc704\uc6d0\ud68c \uae30\uc5c5 \uc7ac\ubb34\uc815\ubcf4)",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://github.com/Koomook/data-go-mcp-servers#fsc-financial-info",
"Homepage": "https://github.com/Koomook/data-go-mcp-servers",
"Issues": "https://github.com/Koomook/data-go-mcp-servers/issues",
"Repository": "https://github.com/Koomook/data-go-mcp-servers"
},
"split_keywords": [
"corporate",
" data.go.kr",
" financial",
" fsc",
" korea",
" llm",
" mcp",
" openapi"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "29422b87c856bbbbc321c4ddefb79358570c76320388d20d9cecaa0821a03e6e",
"md5": "047bdaa9b74f4efd89f6a6d0c01ae09f",
"sha256": "4bece8d90219afcabb4234393264bf7af9bb57cf6b27240f1acd00c8c18fac0d"
},
"downloads": -1,
"filename": "data_go_mcp_fsc_financial_info-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "047bdaa9b74f4efd89f6a6d0c01ae09f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 14312,
"upload_time": "2025-08-28T12:35:29",
"upload_time_iso_8601": "2025-08-28T12:35:29.713076Z",
"url": "https://files.pythonhosted.org/packages/29/42/2b87c856bbbbc321c4ddefb79358570c76320388d20d9cecaa0821a03e6e/data_go_mcp_fsc_financial_info-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7d5cd313c8b5499db0bc83d43916780c2125aee1cbf7e00dc7b2bd666a6c50ae",
"md5": "9c61f1499cef3324610562d4b021560c",
"sha256": "0298c133482b0b3295ab58e3296bcdc8ed5f40a2ee6ba049a6eea7c4f2c73af6"
},
"downloads": -1,
"filename": "data_go_mcp_fsc_financial_info-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "9c61f1499cef3324610562d4b021560c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 17325,
"upload_time": "2025-08-28T12:35:30",
"upload_time_iso_8601": "2025-08-28T12:35:30.940529Z",
"url": "https://files.pythonhosted.org/packages/7d/5c/d313c8b5499db0bc83d43916780c2125aee1cbf7e00dc7b2bd666a6c50ae/data_go_mcp_fsc_financial_info-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-28 12:35:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Koomook",
"github_project": "data-go-mcp-servers#fsc-financial-info",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "data-go-mcp.fsc-financial-info"
}
JSON
