Metadata-Version: 2.4
Name: kiwoom-mcp
Version: 0.1.0
Summary: MCP server for kiwoom-cli — 키움증권 REST API 236종을 AI 에이전트에 연결합니다
Author: Yu Jin
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/gejyn14/kiwoom-plugin
Project-URL: Repository, https://github.com/gejyn14/kiwoom-plugin
Project-URL: Issues, https://github.com/gejyn14/kiwoom-plugin/issues
Project-URL: kiwoom-cli, https://github.com/gejyn14/kiwoom-cli
Keywords: mcp,model-context-protocol,kiwoom,trading,stock,korea
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: kiwoom-cli>=2.14.0
Requires-Dist: mcp<2,>=1.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-httpx>=0.30; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"

# kiwoom-mcp (server)

이 디렉터리는 [kiwoom-plugin](https://github.com/gejyn14/kiwoom-plugin)의 MCP 서버 본체입니다. 플러그인이 `uvx`로 이 디렉터리를 직접 실행하므로 별도 배포(PyPI/npm)가 없습니다.

kiwoom-cli 236종 API를 MCP 도구로 노출합니다. 안전장치(주문 확인 게이트, dry-run, 멱등키, envelope)는 kiwoom-cli의 것을 그대로 통과시킵니다.

## 단독 실행

```bash
uvx --from "git+https://github.com/gejyn14/kiwoom-plugin@v0.1.0#subdirectory=server" kiwoom-mcp
uvx --from "git+https://github.com/gejyn14/kiwoom-plugin@v0.1.0#subdirectory=server" kiwoom-mcp --allow-orders
```

전송·인증·안전 모델은 상위 [README](../README.md)를 참고하세요.

## 개발

```bash
pip install -e ".[dev]"
pytest tests/ -q
ruff check kiwoom_mcp/
```

## 도구

| 도구 | 설명 |
|---|---|
| `kiwoom_describe` | 명령 트리 조회 |
| `kiwoom_find` | 키워드로 명령·API 검색 |
| `kiwoom_run` | 임의의 kiwoom-cli 명령 실행 |
| `kiwoom_stream_snapshot` | 실시간 스트림에서 N개 이벤트 |
| `kiwoom_order_validate` | 주문 사전점검 (read-only) |
| `kiwoom_order` | 주문 전송 — `--allow-orders` 시에만 등록 |

## 라이선스

Apache-2.0.
