kospi-kosdaq-stock-server
An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP.
Features
- Lookup KOSPI/KOSDAQ ticker symbols and names
- Retrieve OHLCV data for a specific stock
- Retrieve market capitalization data for a specific stock
- Retrieve fundamental data (PER/PBR/Dividend Yield) for a specific stock
- Retrieve trading volume by investor type for a specific stock
Available Tools
-
load_all_tickers- Loads all ticker symbols and names for KOSPI and KOSDAQ into memory.- No arguments.
-
get_stock_ohlcv- Retrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock.fromdate(string, required): Start date for retrieval (YYYYMMDD)todate(string, required): End date for retrieval (YYYYMMDD)ticker(string, required): Stock ticker symboladjusted(boolean, optional): Whether to use adjusted prices (True: adjusted, False: unadjusted). Defaults to True.
-
get_stock_market_cap- Retrieves market capitalization data for a specific stock.fromdate(string, required): Start date for retrieval (YYYYMMDD)todate(string, required): End date for retrieval (YYYYMMDD)ticker(string, required): Stock ticker symbol
-
get_stock_fundamental- Retrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock.fromdate(string, required): Start date for retrieval (YYYYMMDD)todate(string, required): End date for retrieval (YYYYMMDD)ticker(string, required): Stock ticker symbol
-
get_stock_trading_volume- Retrieves trading volume by investor type for a specific stock.fromdate(string, required): Start date for retrieval (YYYYMMDD)todate(string, required): End date for retrieval (YYYYMMDD)ticker(string, required): Stock ticker symbol
Installation
This package requires uv for installation and execution.
Installing via Smithery
To install KOSPI/KOSDAQ Stock Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude
Manual Installation
# Create and activate a virtual environment
uv venv .venv
source .venv/bin/activate # On Unix/macOS
# .venv\Scripts\activate # On Windows
# Install the package
uv pip install kospi-kosdaq-stock-server
Configuration for Claude.app
After installing the package, you need to configure the MCP server in your claude_desktop_config.json file.
-
Locate the configuration file:
- On macOS, the file is typically located at:
/Users/username/Library/Application Support/Claude/claude_desktop_config.json - On Windows, the file is typically located at:
%APPDATA%/Claude/claude_desktop_config.json
- On macOS, the file is typically located at:
-
Add the server configuration: Open the
claude_desktop_config.jsonfile and add a new entry to themcpServersobject:
{
"mcpServers": {
"kospi-kosdaq": {
"command": "uvx",
"args": ["kospi_kosdaq_stock_server"]
}
}
}
Configuration Details:
command: Useuvxto take advantage of uv's isolation and dependency managementargs: Only the package name is needed since the entry point is defined in the package- No additional environment variables are required
- Restart Claude: After saving the changes to
claude_desktop_config.json, restart Claude for the changes to take effect.
Usage Example
After configuring the server, you can use it in Claude like this:
- First, load all available stock tickers:
Human: Please load all available stock tickers.
Assistant: I'll help you load all KOSPI and KOSDAQ stock tickers.
> Using tool 'load_all_tickers'...
Successfully loaded 2,873 stock tickers.
- Get OHLCV data for a specific stock:
Human: Show me Samsung Electronics' stock data for the last month.
Assistant: I'll retrieve Samsung Electronics' (005930) OHLCV data for the last month.
> Using tool 'get_stock_ohlcv'...
Date Open High Low Close Volume
2024-02-14 73,800 74,000 73,400 73,700 7,823,124
2024-02-13 73,600 74,200 73,200 73,800 8,943,217
...
Metadata
Release files for iflow-mcp_kospi-kosdaq-stock-server 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_kospi_kosdaq_stock_server-0.2.2.tar.gz | 69.1 kB | Without provenance | Details for iflow_mcp_kospi_kosdaq_stock_server-0.2.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_kospi_kosdaq_stock_server-0.2.2-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_kospi_kosdaq_stock_server-0.2.2-py3-none-any.whl |
Total release size: 145.0 kB
Release files / iflow_mcp_kospi_kosdaq_stock_server-0.2.2.tar.gz
| Download URL | iflow_mcp_kospi_kosdaq_stock_server-0.2.2.tar.gz |
|---|---|
| Size | 69.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
73a14a57c9a5fd503b422163a605fd6439883386298a8dc4e54a1144cb6c6fd8
|
|
BLAKE2b-256 checksum How to use checksums |
b7956a0c20d793a79e8325954d687a4ead0825eb20ccb35ac870e05fa75e3d87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Release files / iflow_mcp_kospi_kosdaq_stock_server-0.2.2-py3-none-any.whl
| Download URL | iflow_mcp_kospi_kosdaq_stock_server-0.2.2-py3-none-any.whl |
|---|---|
| Size | 75.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6e4eccb6b803866481236efd0cd263fa6be015faf858350ecd5102cebc4c34d
|
|
BLAKE2b-256 checksum How to use checksums |
11f989312f88e55c059bb613783c4975628160b4420470433d679272002367bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Security for iflow-mcp_kospi-kosdaq-stock-server 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.