@sazuapp/mcp-server 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# @sazuapp/mcp-server
|
|
2
2
|
|
|
3
3
|
[SAZU API](https://sazu.app/manse-api) 의 **MCP (Model Context Protocol)** 서버.
|
|
4
|
-
AI 에이전트 (Claude Code, Cursor, Windsurf 등) 가 사주·만세력 API 를 직접 호출합니다.
|
|
4
|
+
AI 에이전트 (Claude Code, Cursor, Windsurf, Codex, Antigravity 등) 가 사주·만세력 API 를 직접 호출합니다.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
sazu.app 에서 제공하는 manse-api 이용자들을 위한 mcp-server 입니다.
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
<br/><br/><br/><br/><br/><br/>
|
|
9
9
|
|
|
10
10
|
## 설치
|
|
11
11
|
|
|
@@ -33,9 +33,50 @@ claude mcp add sazu --env SAZU_API_KEY=sazu_pro_xxx -- npx -y @sazuapp/mcp-serve
|
|
|
33
33
|
}
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
### OpenAI Codex CLI
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
CLI 한 줄:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
codex mcp add sazu --env SAZU_API_KEY=sazu_pro_xxx -- npx -y @sazuapp/mcp-server
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
또는 `~/.codex/config.toml` 에 직접 추가:
|
|
45
|
+
|
|
46
|
+
```toml
|
|
47
|
+
[mcp_servers.sazu]
|
|
48
|
+
command = "npx"
|
|
49
|
+
args = ["-y", "@sazuapp/mcp-server"]
|
|
50
|
+
env = { SAZU_API_KEY = "sazu_pro_xxx" }
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### Google Antigravity
|
|
54
|
+
|
|
55
|
+
Antigravity 에디터 우상단 "…" → **Manage MCP Servers** → **View raw config** → `mcp_config.json` 편집:
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"mcpServers": {
|
|
60
|
+
"sazu": {
|
|
61
|
+
"command": "npx",
|
|
62
|
+
"args": ["-y", "@sazuapp/mcp-server"],
|
|
63
|
+
"env": {
|
|
64
|
+
"SAZU_API_KEY": "sazu_pro_xxx"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
<br/><br/><br/><br/><br/><br/>
|
|
72
|
+
|
|
73
|
+
## 시작하기
|
|
74
|
+
|
|
75
|
+
1. [https://sazu.app/manse-api](https://sazu.app/manse-api) — 서비스 소개·가격 확인
|
|
76
|
+
2. [Pro 구독](https://sazu.app/manse-api/pricing) — Free 사용자는 [docs 페이지](https://sazu.app/manse-api/docs) 의 curl 예시 활용
|
|
77
|
+
3. [대시보드 → 키 발급](https://sazu.app/manse-api/dashboard/keys) — `SAZU_API_KEY` 환경변수에 설정
|
|
78
|
+
|
|
79
|
+
<br/><br/><br/><br/><br/><br/>
|
|
39
80
|
|
|
40
81
|
## 노출 도구
|
|
41
82
|
|
|
@@ -44,6 +85,8 @@ claude mcp add sazu --env SAZU_API_KEY=sazu_pro_xxx -- npx -y @sazuapp/mcp-serve
|
|
|
44
85
|
| `sazu_calculate` | 사주팔자 + 14개 명리 분석 (오행·합형충파해·격국·용신·12운성·신살·허자·대운 등) |
|
|
45
86
|
| `sazu_calendar_convert` | 양력 ↔ 음력 변환 (200년 만세력) |
|
|
46
87
|
|
|
88
|
+
<br/><br/><br/><br/><br/><br/>
|
|
89
|
+
|
|
47
90
|
## 사용 예시
|
|
48
91
|
|
|
49
92
|
AI 에이전트에게 자연어로:
|
|
@@ -55,6 +98,8 @@ AI 에이전트에게 자연어로:
|
|
|
55
98
|
|
|
56
99
|
→ AI 가 `sazu_calculate` / `sazu_calendar_convert` 도구를 자동 호출.
|
|
57
100
|
|
|
101
|
+
<br/><br/><br/><br/><br/><br/>
|
|
102
|
+
|
|
58
103
|
## 환경변수
|
|
59
104
|
|
|
60
105
|
| 변수 | 기본값 | 설명 |
|
|
@@ -62,17 +107,15 @@ AI 에이전트에게 자연어로:
|
|
|
62
107
|
| `SAZU_API_KEY` | (필수) | Pro 플랜 API 키 |
|
|
63
108
|
| `SAZU_API_BASE` | `https://api.sazu.app` | API 베이스 URL (커스텀 환경용) |
|
|
64
109
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
- 시작 시 `/v1/me` 호출로 tier 검증 → Pro 가 아니면 즉시 종료
|
|
68
|
-
- 모든 요청에 `X-Client-Type: mcp` 헤더 부착 (서버 측 통계 분리)
|
|
69
|
-
- 응답에 `X-Response-Id` watermark — 유출 시 추적 가능
|
|
110
|
+
<br/><br/><br/><br/><br/><br/>
|
|
70
111
|
|
|
71
112
|
## 제한
|
|
72
113
|
|
|
73
114
|
- 운세 텍스트 생성 기능은 노출하지 않습니다 (별도 라이선스 필요)
|
|
74
115
|
- 인증·결제 엔드포인트는 노출하지 않습니다
|
|
75
116
|
|
|
117
|
+
<br/><br/><br/><br/><br/><br/>
|
|
118
|
+
|
|
76
119
|
## 문의
|
|
77
120
|
|
|
78
121
|
contact@sazu.app
|