feat: mcp 서버 추가 (claude desktop / chatgpt desktop 지원)

- 9개 tool 제공 (7 카테고리 + schema + rate_limit)
- stdio transport 기반 MCP 서버 (krx-mcp 바이너리)
- 기존 client/validator 코드 재사용, 중복 없음
- esbuild 멀티 엔트리 빌드 (dist/cli.js + dist/mcp.js)
- README에 Claude Desktop / ChatGPT Desktop 설정 가이드 추가

Author: kyo504

README.md

@@ -224,6 +224,80 @@ mkdir -p ~/.claude/skills && cp SKILL.md ~/.claude/skills/krx-cli.md
 mkdir -p ~/.cursor/skills && cp SKILL.md ~/.cursor/skills/krx-cli.md
 ```
 
+## MCP 서버 (Claude Desktop / ChatGPT Desktop)
+
+CLI 외에 MCP(Model Context Protocol) 서버도 제공합니다. Claude Desktop, ChatGPT Desktop 등 MCP를 지원하는 클라이언트에서 사용할 수 있습니다.
+
+### 설정 (Claude Desktop)
+
+API 키는 `krx auth set <key>`로 등록한 것이 자동으로 사용됩니다.
+`krx-mcp`는 `npm install -g krx-cli`로 설치하면 함께 설치됩니다.
+
+### Claude Desktop
+
+설정 파일 위치:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "krx": {
+      "command": "krx-mcp"
+    }
+  }
+}
+```
+
+### ChatGPT Desktop
+
+설정 파일 위치:
+
+- **macOS**: `~/Library/Application Support/com.openai.chat/mcp.json`
+- **Windows**: `%LOCALAPPDATA%\OpenAI\ChatGPT\mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "krx": {
+      "command": "krx-mcp"
+    }
+  }
+}
+```
+
+설정 후 앱을 재시작하면 MCP 도구가 활성화됩니다.
+
+### 제공 Tool
+
+| Tool             | 설명                                       |
+| ---------------- | ------------------------------------------ |
+| `krx_index`      | 지수 일별시세 (KOSPI/KOSDAQ/KRX/채권/파생) |
+| `krx_stock`      | 주식 일별매매정보 + 종목 기본정보          |
+| `krx_etp`        | ETF/ETN/ELW 일별매매정보                   |
+| `krx_bond`       | 채권 일별매매정보 (국채/일반/소액)         |
+| `krx_derivative` | 선물/옵션 일별매매정보                     |
+| `krx_commodity`  | 금/석유/배출권 일별매매정보                |
+| `krx_esg`        | ESG 지수/채권/ETP 정보                     |
+| `krx_schema`     | 엔드포인트 응답 필드 스키마 조회           |
+| `krx_rate_limit` | 일일 API 호출 현황 조회                    |
+
+### 사용 예시
+
+MCP 클라이언트에서 자연어로 요청하면 됩니다:
+
+```
+"오늘 코스피 지수 보여줘"
+→ krx_index tool 호출 (endpoint: "kospi_dd_trd")
+
+"삼성전자 주가 알려줘"
+→ krx_stock tool 호출 (endpoint: "stk_bydd_trd", fields: ["ISU_NM", "TDD_CLSPRC", "FLUC_RT"])
+
+"오늘 API 몇 번 호출했어?"
+→ krx_rate_limit tool 호출
+```
+
 ## 개발
 
 ```bash

esbuild.config.js

@@ -1,19 +1,28 @@
 import { build } from "esbuild";
 import { rmSync } from "node:fs";
 
-const watch = process.argv.includes("--watch");
-
 rmSync("dist", { recursive: true, force: true });
 
-const ctx = await build({
-  entryPoints: ["src/cli/index.ts"],
+const commonOptions = {
   bundle: true,
   format: "esm",
   platform: "node",
   target: "node20",
-  outfile: "dist/cli.js",
   sourcemap: true,
   banner: {
     js: "#!/usr/bin/env node\nimport{createRequire}from'node:module';const require=createRequire(import.meta.url);",
   },
-});
+};
+
+await Promise.all([
+  build({
+    ...commonOptions,
+    entryPoints: ["src/cli/index.ts"],
+    outfile: "dist/cli.js",
+  }),
+  build({
+    ...commonOptions,
+    entryPoints: ["src/mcp/index.ts"],
+    outfile: "dist/mcp.js",
+  }),
+]);

package.json

@@ -4,7 +4,8 @@
   "description": "Agent-native CLI for KRX (Korea Exchange) Open API",
   "type": "module",
   "bin": {
-    "krx": "./dist/cli.js"
+    "krx": "./dist/cli.js",
+    "krx-mcp": "./dist/mcp.js"
   },
   "files": [
     "dist",
@@ -41,6 +42,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "commander": "^14.0.3",
     "zod": "^4.3.6"
   },