Content
# MCP Korean Stock Server
MCP Server providing Korean stock data based on Naver Finance API. You can query Korean stock information directly from Claude Code/Desktop.
No external dependencies, only using Python standard libraries.
## Tool List
| Tool | Description |
|------|-------------|
| `stock_price` | Get current stock price |
| `stock_detail` | Get detailed information (open/high/low price, trading volume, market cap, PER, PBR, etc.) |
| `stock_search` | Search stock code by stock name |
| `market_index` | Get KOSPI/KOSDAQ index |
| `stock_news` | Get latest news related to a stock |
## Setup
### Claude Code
```bash
claude mcp add korean-stock python3 /path/to/server.py
```
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"korean-stock": {
"command": "python3",
"args": ["/path/to/server.py"]
}
}
}
```
## Usage Examples
- "Give me the current price of Samsung Electronics"
- "Search for the stock code of Kakao"
- "What is the KOSPI index?"
- "Tell me the PER and market cap of SK Hynix"
- "Show me the latest news of Samsung Electronics"
## Requirements
- Python 3.8+
- No external dependencies
## Data Source
Uses Naver Finance mobile API (`m.stock.naver.com`).
Please use for personal purposes only.
## License
MIT
