使用说明
基伍姆mcp
Kiwoom证券REST API 模型上下文协议（MCP） 用工具包装的服务器。 您可以在Claude Code等支持MCP的LLM客户端上直接查询韩国股票信息。
当前版本仅用于查询。 不包括订购（买入/卖出/取消）功能。
免责声明（Disclaimer）
使用本软件产生的所有后果完全由您自己负责。
- 这个项目 个人学习和便利目的由制作，不是Kiwoom证券的官方产品。
- 不提供投资建议、交易建议或利润保证。
- API调用导致的罚款、数据错误、账户信息泄露、令牌泄露等 对于任何直接或间接损害，制作者不承担责任。
- 请务必查看Kiwoom证券OpenAPI使用条款，并在您的责任下使用。
- API密钥和秘密密钥 千万不要提交到公共存储库。 环境变量或
.env请用文件管理。 - 不保证通过此工具查询的数据的准确性。请务必通过官方HTS/MTS确认实际投资判断。
事前准备
- Kiwoom证券OpenAPI申请: Kiwoom OpenAPI门户在中申请使用REST API
- 发放App Key/Secret Key：通过OpenAPI门户发布
- Node.js 18+ 安装
交付工具
| 工具名 | 说明 | 输入参数 |
|---|---|---|
get_stock_price |
查询当前价格（项目名称、涨跌率、PER、PBR等） | stockCode （6位数） |
get_orderbook |
报价查询（卖出/买入1-10报价，余量） | stockCode |
get_daily_chart |
日薪图表（市/高/低/收盘价，交易量） | stockCode, baseDate? （YYYMMDD） |
get_investor_trend |
各投资者的交易动向（外国投资者/机构/个人净买入） stockCode |
|
get_account_balance |
账户评估情况（预收款、持有项目、损益率） | 无 |
get_deposit |
查询存款详情（可提款，可订购金额） | 无 |
get_unfilled_orders 查询未签署订单没有 |
||
get_filled_orders |
查询签署明细 | stockCode? （未输入时全部） |
安装
git clone https://github.com/java-jaydev/kiwoom-mcp.git
cd kiwoom-mcp
pnpm install
pnpm run build
pnpm如果没有npm install && npm run build也可以。
环境变量
| 变量名 | 必需的 | 说明 |
|---|---|---|
KIWOOM_APP_KEY |
O | Kiwoom OpenAPI App Key |
KIWOOM_SECRET_KEY |
O | Kiwoom OpenAPI Secret Key |
KIWOOM_API_BASE_URL |
X | API基础URL（默认值： https://api.kiwoom.com) |
Claude Code集成
方法1:CLI命令（推荐）
claude mcp add --transport stdio --scope user kiwoom \
--env KIWOOM_APP_KEY=<your-app-key> \
--env KIWOOM_SECRET_KEY=<your-secret-key> \
-- node /path/to/kiwoom-mcp/dist/index.js
方法2：.mcp.json（项目视图）
在项目根目录中 .mcp.json 创建：
{
"mcpServers": {
"kiwoom": {
"type": "stdio",
"command": "node",
"args": ["/path/to/kiwoom-mcp/dist/index.js"],
"env": {
"KIWOOM_APP_KEY": "<your-app-key>",
"KIWOOM_SECRET_KEY": "<your-secret-key>"
}
}
}
}
.mcp.json必须包含API密钥.gitignore添加到。
设置后重新启动Claude Code /mcp 使用命令检查服务器连接。
验证
# MCP Inspector로 로컬 테스트
npx @modelcontextprotocol/inspector node dist/index.js
# Claude Code에서 연동 확인
# /mcp 명령어로 서버 상태 확인 후 "삼성전자 현재가 알려줘" 등 질의
注意事项
- IP限制：Kiwoom API令牌仅在颁发的IP上有效。服务器和客户端必须在同一IP上运行。
- 令牌管理：令牌有效期24小时，过期前1小时自动续订。
- 章节运行时间：收盘后，市价/高价/低价可能会返回0。
- 价格符号：Kiwoom API响应的价格
+/-加上符号，将当前价格等转换为绝对值并返回。 - 速率限制：请遵守Kiwoom API的调用限制。过度呼叫可能会被阻止。
技术堆栈
- TypeScript+Node.js（ES模块）
- @模型上下文协议/sdk
- 佐德 （输入验证）
- 标准运输
许可证
MIT许可证
贡献
欢迎话题和PR。但是， 千万不要提交包含API密钥或秘密密钥的内容。