Metadata-Version: 2.4
Name: daol-mcp
Version: 0.1.38
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
Requires-Dist: tzdata; sys_platform == 'win32'
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 도구를 고르면 등록까지 끝나고, 해당 앱을 재시작하면 바로 사용할 수 있습니다.


### 지원 AI 도구

Claude Desktop · Claude Code · Cursor · Codex · ChatGPT 데스크톱.
(ChatGPT 데스크톱은 Codex와 같은 설정을 공유하므로, Codex를 따로 설치하지 않아도 됩니다.
ChatGPT 웹은 로컬 설정을 읽지 않아 지원하지 않습니다.)

### 지원 환경

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

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

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

Windows는 공식 Python을 `%LOCALAPPDATA%\DAOL\MCP`에 설치합니다. 별도 Python·uv 설치나
관리자 권한은 필요하지 않습니다. 기존 `daol-mcp.exe`로 등록된 AI 도구는 설치 중 실행 경로가 갱신됩니다.
설치·업데이트 전에 AI 도구를 완전히 종료하고, 완료 후 다시 실행하세요.

## 명령어

Windows에서도 대부분의 PC 에서는 아래 표의 짧은 명령을 그대로 쓸 수 있습니다(설치 후 새로 연
PowerShell·명령 프롬프트에서). Smart App Control 이 켜진 PC 는 스크립트 실행이 막혀 짧은 명령을
만들지 않으므로, 설치 도우미가 안내하는 다음 형식을 씁니다. 마지막 `doctor`를 `setup`, `accounts`,
`update`, `logout` 등으로 바꾸면 됩니다.

```powershell
& "$env:LOCALAPPDATA\DAOL\MCP\runtime\python.exe" -I -X utf8 -m daol_local_mcp doctor
```

| 명령 | 설명 |
|---|---|
| `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 로만 동작**: 네트워크 포트를 열지 않습니다.
- 공식 PyPI의 공개 패키지를 설치하며 소스 빌드를 허용하지 않습니다.
- Windows Python·설치 도구는 버전과 SHA-256을 고정하고 Python의 PSF 코드 서명을 확인합니다.
- Smart App Control이 네이티브 의존성을 차단하면 설치 검사가 중단됩니다. 보안 설정을 끄지 말고
  `%TEMP%\daol-install.log`와 차단 파일명을 지원팀에 전달해주세요.

## 제거

**Windows PowerShell**

먼저 연결을 해제한 뒤 AI 도구를 완전히 종료하고 프로그램 폴더를 삭제합니다.

```powershell
& "$env:LOCALAPPDATA\DAOL\MCP\runtime\python.exe" -I -X utf8 -m daol_local_mcp logout
Remove-Item -LiteralPath "$env:LOCALAPPDATA\DAOL\MCP" -Recurse -Force
```

이전 uv 설치본도 남아 있다면 `uv tool uninstall daol-mcp`로 별도 제거할 수 있습니다.

**macOS/Linux**

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