键石_MCP_服务器
项目介绍
韩国投资证券 REST API MCP (模型上下文协议)
韩国投资证券(KIS)的REST API用于股票交易及行情信息查询的MCP（模型上下文协议）服务器。提供包括国内及海外股票交易、行情查询、账户管理等在内的多种金融交易功能。
✨ 主要功能
-
🇰🇷 国内股票交易
- 实时当前价查询
- 买入/卖出订单
- 余额查询
- 委托信息查询
- 订单历史查询
-
🌏 海外股票交易
- 支持美国、日本、中国、香港、越南等主要市场
- 实时当前价查询
- 买入/卖出订单
-
⚡ 特点
- 异步处理快速响应
- 实时行情及成交信息
- 稳健的错误处理
- 可扩展设计
⚠️ 注意事项
此项目仍处于开发中，尚未完成。在实际投资使用前，请务必进行充分测试。
- 使用本项目产生的所有损失和责任完全由用户承担。
- 使用API时需遵守韩国投资证券的服务条款。
- 使用真实账户时需谨慎，并建议使用模拟投资账户进行充分测试。
- 必须确认与API调用限制相关的约束条件。
要求
- Python >= 3.13
- uv (Python打包工具)
安装
# 1. 如果未安装，请安装 uv
pip install uv
# 2. 创建并激活虚拟环境
uv venv
source .venv/bin/activate # Linux/MacOS
# 或
.venv\\Scripts\\activate # Windows
# 3. 安装依赖项
uv pip install -e .
mcp install server.py \
-v KIS_APP_KEY={KIS_APP_KEY} \
-v KIS_APP_SECRET={KIS_APP_SECRET} \
-v KIS_ACCOUNT_TYPE={KIS_ACCOUNT_TYPE} \
-v KIS_CANO={KIS_CANO}
MCP 服务器配置
您也可以通过JSON配置文件来配置MCP服务器。创建一个名为mcp-config.json的文件，内容如下（替换路径和环境变量为您自己的）：
{
"mcpServers": {
"KIS MCP Server": {
"command": "/opt/homebrew/bin/uv",
"args": [
"run",
"--with",
"httpx",
"--with",
"mcp[cli]",
"--with",
"xmltodict",
"mcp",
"run",
"/path/to/your/project/server.py"
],
"env": {
"KIS_APP_KEY": "your_app_key",
"KIS_APP_SECRET": "your_secret_key",
"KIS_ACCOUNT_TYPE": "VIRTUAL",
"KIS_CANO": "your_account_number"
}
}
}
}
此配置可用于与MCP兼容的工具和IDE，以运行具有指定依赖项和环境变量的服务器。
功能
国内股票交易
-
inquery_stock_price - 查询股票当前价格
symbol: 股票代码（例如："005930"）（字符串，必需）- 返回：当前价格、涨跌额、涨跌幅、成交量等
-
order_stock - 下单买卖股票
symbol: 股票代码（字符串，必需）quantity: 下单数量（数字，必需）price: 下单价格（0：市价）（数字，必需）order_type: 下单类型（"buy"或"sell"）（字符串，必需）
-
inquery_balance - 查询账户余额
- 返回：持有股票、评估价值、盈亏情况等
-
inquery_order_list - 查询每日订单历史
start_date: 查询开始日期（YYYYMMDD）（字符串，必需）end_date: 查询结束日期（YYYYMMDD）（字符串，必需）
-
inquery_order_detail - 查询订单详细信息
order_no: 订单号（字符串，必需）order_date: 订单日期（YYYYMMDD）（字符串，必需）
-
inquery_stock_ask - 查询委托信息
symbol: 股票代码（字符串，必需）- 返回：卖方/买方委托、委托量等
海外股票交易
-
order_overseas_stock - 下单买卖海外股票
symbol: 股票代码（例如："AAPL"）（字符串，必需）quantity: 下单数量（数字，必需）price: 下单价格（数字，必需）order_type: 下单类型（"buy"或"sell"）（字符串，必需）market: 市场代码（字符串，必需）- "NASD": 纳斯达克
- "NYSE": 纽约
- "AMEX": 美交所
- "SEHK": 香港
- "SHAA": 上海
- "SZAA": 深圳
- "TKSE": 日本
- "HASE": 越南河内
- "VNSE": 越南胡志明
-
inquery_overseas_stock_price - 查询海外股票当前价格
symbol: 股票代码（字符串，必需）market: 市场代码（字符串，必需）
资源
配置
通过环境变量设置API密钥和账户信息：
KIS_APP_KEY: 韩国投资证券应用密钥KIS_APP_SECRET: 韩国投资证券秘密密钥KIS_ACCOUNT_TYPE: 账户类型（"REAL"或"VIRTUAL"）KIS_CANO: 账户号码
交易时间
国内股票：
- 正常交易时段：09:00 ~ 15:30
- 盘后单一价格：15:40 ~ 16:00
海外股票：
- 美国（纳斯达克/纽约）：22:30 ~ 05:00（韩国时间）
- 日本：09:00 ~ 15:10
- 中国：10:30 ~ 16:00
- 香港：10:30 ~ 16:00
- 越南：11:15 ~ 16:15
错误处理
API调用可能发生的常见错误：
- 认证错误：API密钥或秘密密钥不正确
- 余额不足：下单金额超过账户余额
- 时间限制：非交易时间
- 订单限制：下单数量或金额超出限制
关于
- 可扩展设计
- 异步处理快速响应
- 实时行情及成交信息
- 稳健的错误处理
许可证
MIT 许可证