KIS_MCP_Server

🚀 韩国投资证券 REST API MCP（模型上下文协议）

通过韩国投资证券(KIS)的REST API，借助MCP（模型上下文协议）服务器，可实现股票交易以及市场行情信息的查询。该系统支持国内及海外股票交易、账户管理等多样化金融服务，为用户提供便捷、高效的金融交易体验。

🚀 快速开始

本项目可通过韩国投资证券的REST API，利用MCP服务器开展股票交易和市场行情信息查询等操作。使用前，需按以下步骤配置相关信息。

✨ 主要特性

• 🇰🇷 国内股票交易

  • 实时当前价查询
  • 买入/卖出订单
  • 资金余额查询
  • 报价信息查询
  • 订单记录查询

• 🌍 海外股票交易

  • 查询海外市场实时行情（包括美国、日本、中国、香港、越南等）
  • 根据市场代码和股票代码进行价格查询
  • 下达买入或卖出指令

⚠️ 重要提示

请勿随意泄露API密钥，确保账户安全。使用前需仔细阅读相关协议。

📦 安装指南

通过环境变量配置API密钥和账户信息：

• KIS_APP_KEY：韩国投资证券应用编程接口密钥
• KIS_APP_SECRET：韩国投资证券应用程序加密密钥
• KIS_ACCOUNT_TYPE：账户类型（"REAL" 或 "VIRTUAL"）
• KIS_CANO：客户账号

💻 使用示例

国内股票交易功能

| 函数名称 | 描述 | |---------------------------|------------------------| | inquiry_domestic_stock_price | 查询国内股票实时行情 | | order_purchase | 下达买入委托指令 | | order_sale | 下达卖出委托指令 | | inquiry_balance | 查询账户资金余额 | | inquiry_order | 查询当前订单状态 |

海外股票交易功能

| 函数名称 | 描述 | |----------------------------------|------------------------| | inquiry_overseas_stock_price | 根据市场代码查询海外股票价格 | | order_purchase_international | 下达国际买入委托指令 | | order_sale_international | 下达国际卖出委托指令 |

📚 详细文档

⏰ 交易时间

国内股票：

• 正常交易时段：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密钥错误）
• 资金不足（订单金额超过账户余额）
• 非交易时段操作
• 订单数量或金额超出限制

📜 关于项目

• 具有扩展性设计
• 采用异步处理实现快速响应
• 提供实时行情和成交信息
• 稳定的错误处理机制