Metadata-Version: 2.4
Name: daol-mcp
Version: 0.1.14
Summary: 다올투자증권 Local MCP 서버 — AI 도구에서 본인 계좌를 안전하게 조회·주문
Project-URL: Homepage, https://mcp.daolfn.com
Project-URL: Repository, https://github.com/daol-securities/daol-mcp
Project-URL: Issues, https://github.com/daol-securities/daol-mcp/issues
Author: DAOL Investment & Securities
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai,claude,daol,mcp,stock,trading
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
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.11
Requires-Dist: fastmcp==3.4.4
Requires-Dist: httpx==0.28.1
Requires-Dist: keyring==25.7.0
Requires-Dist: pydantic==2.13.4
Requires-Dist: secretstorage==3.5.0; sys_platform == 'linux'
Requires-Dist: truststore==0.10.4
Requires-Dist: typer==0.26.8
Description-Content-Type: text/markdown

# 다올투자증권 MCP

다올투자증권 계좌를 MCP 호환 **AI 도구에서 본인 키로 직접**
조회·주문할 수 있게 해 주는 로컬 MCP 서버입니다.

> AI와 증권 계좌를 한 줄로 연결하다. [mcp.daolfn.com](https://mcp.daolfn.com)

## 지원 기능

AI에게 자연어로 요청하면 아래를 대신 수행합니다. 주문류는 **미리보기 → 확인 → 실행**
순서로만 움직여, 예상 체결금액·수수료·위험 안내를 먼저 보여 주고 확인한 주문만 전송합니다.

**조회 도구**
- **계좌·잔고**: 예수금·평가금액·총자산·평가손익, 보유 종목(마스킹된 계좌번호)
- **시세**: 종목 현재가·등락률·거래량·호가
- **주문 내역**: 체결·미체결 주문 목록과 개별 주문 상세

**주문 도구** (미리보기 → 확인 후 실행)
- **매수·매도**: 지정가·시장가 주문
- **정정·취소**: 미체결 주문 정정·취소

현재는 **국내주식을 우선 지원**하며, **해외주식은 지원 예정**입니다.

## 설치

먼저 다올투자증권 **Fi 앱 → 고객 서비스 → MCP 이용 신청**에서
**App Key / App Secret** 을 발급받으세요.

**macOS / Linux**
```bash
curl -fsSL https://mcp.daolfn.com/install.sh | sh
```

**Windows (PowerShell)**
```powershell
irm https://mcp.daolfn.com/install.ps1 | iex
```

설치가 끝나면 **설치 도우미**가 떠서 App Key / App Secret 을 입력받습니다.
이어서 연결할 AI 도구를 고르면 등록까지 끝나고, 해당 앱을 재시작하면 바로 사용할 수 있습니다.


### 지원 환경

- **macOS**: Intel·Apple Silicon의 일반 사용자 터미널
- **Windows 10/11**: Windows PowerShell 또는 PowerShell 7의 일반 사용자 세션
- **Linux**: GNOME Keyring·KWallet 등 Secret Service와 사용자 D-Bus 세션이 실행 중인 데스크톱

WSL 안에 설치한 MCP는 Windows용 Claude Desktop/Cursor 설정과 자동으로 공유되지 않습니다.
Windows GUI 앱에서 사용할 때는 WSL이 아니라 Windows PowerShell에서 설치하세요. 헤드리스 Linux는
키체인을 별도로 구성해야 하므로 1차 일반 사용자 지원 대상이 아닙니다.

AI 도구를 찾지 못했다는 안내가 나오면 Claude Desktop/Cursor 등을 한 번 실행해 설정 디렉터리를
만든 뒤 `daol-mcp setup`을 다시 실행하세요.

## 명령어

| 명령 | 설명 |
|---|---|
| `daol-mcp setup` | 설치 도우미(키 입력·검증·AI 도구 등록) 재실행 |
| `daol-mcp doctor` | 설치/연결 상태 점검 |
| `daol-mcp accounts` | 부여된 권한·계좌 확인 |
| `daol-mcp serve` | MCP 서버 실행 (보통 AI 도구가 자동 실행) |
| `daol-mcp update` | 최신 공개 버전으로 업데이트 |
| `daol-mcp logout` | 키체인 비밀값 삭제 + 토큰 폐기 + 등록 제거 |

## 보안

- **비밀값은 OS 키체인에만.** 평문 파일·로그·AI 도구 설정에 App Secret 을 저장하지 않습니다.
- **모든 서버 통신은 HTTPS 강제.**
- **MCP 서버는 로컬 stdio 로만 동작**: 네트워크 포트를 열지 않습니다.
- 설치 시 검증된 공개 릴리스 버전을 정확히 지정해 설치합니다.

## 제거

완전히 제거하려면 먼저 `daol-mcp logout`을 실행한 다음 아래 명령을 실행하세요.

```bash
uv tool uninstall daol-mcp
```
