careerly-data-mcp 2.0.0
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 +230 -0
- package/dist/bigquery/auth.d.ts +18 -0
- package/dist/bigquery/auth.d.ts.map +1 -0
- package/dist/bigquery/auth.js +46 -0
- package/dist/bigquery/auth.js.map +1 -0
- package/dist/bigquery/client.d.ts +77 -0
- package/dist/bigquery/client.d.ts.map +1 -0
- package/dist/bigquery/client.js +495 -0
- package/dist/bigquery/client.js.map +1 -0
- package/dist/bigquery/index.d.ts +7 -0
- package/dist/bigquery/index.d.ts.map +1 -0
- package/dist/bigquery/index.js +7 -0
- package/dist/bigquery/index.js.map +1 -0
- package/dist/bigquery/types.d.ts +137 -0
- package/dist/bigquery/types.d.ts.map +1 -0
- package/dist/bigquery/types.js +40 -0
- package/dist/bigquery/types.js.map +1 -0
- package/dist/cli/setup.d.ts +30 -0
- package/dist/cli/setup.d.ts.map +1 -0
- package/dist/cli/setup.js +859 -0
- package/dist/cli/setup.js.map +1 -0
- package/dist/ga4/auth.d.ts +29 -0
- package/dist/ga4/auth.d.ts.map +1 -0
- package/dist/ga4/auth.js +73 -0
- package/dist/ga4/auth.js.map +1 -0
- package/dist/ga4/client.d.ts +51 -0
- package/dist/ga4/client.d.ts.map +1 -0
- package/dist/ga4/client.js +223 -0
- package/dist/ga4/client.js.map +1 -0
- package/dist/ga4/index.d.ts +7 -0
- package/dist/ga4/index.d.ts.map +1 -0
- package/dist/ga4/index.js +7 -0
- package/dist/ga4/index.js.map +1 -0
- package/dist/ga4/types.d.ts +115 -0
- package/dist/ga4/types.d.ts.map +1 -0
- package/dist/ga4/types.js +63 -0
- package/dist/ga4/types.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +114 -0
- package/dist/index.js.map +1 -0
- package/dist/insight/renderer.d.ts +29 -0
- package/dist/insight/renderer.d.ts.map +1 -0
- package/dist/insight/renderer.js +194 -0
- package/dist/insight/renderer.js.map +1 -0
- package/dist/mcp/server.d.ts +20 -0
- package/dist/mcp/server.d.ts.map +1 -0
- package/dist/mcp/server.js +50 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/tools/bq-ga4-events.d.ts +10 -0
- package/dist/tools/bq-ga4-events.d.ts.map +1 -0
- package/dist/tools/bq-ga4-events.js +396 -0
- package/dist/tools/bq-ga4-events.js.map +1 -0
- package/dist/tools/bq-metadata.d.ts +10 -0
- package/dist/tools/bq-metadata.d.ts.map +1 -0
- package/dist/tools/bq-metadata.js +237 -0
- package/dist/tools/bq-metadata.js.map +1 -0
- package/dist/tools/bq-query.d.ts +10 -0
- package/dist/tools/bq-query.d.ts.map +1 -0
- package/dist/tools/bq-query.js +357 -0
- package/dist/tools/bq-query.js.map +1 -0
- package/dist/tools/metadata.d.ts +11 -0
- package/dist/tools/metadata.d.ts.map +1 -0
- package/dist/tools/metadata.js +135 -0
- package/dist/tools/metadata.js.map +1 -0
- package/dist/tools/query.d.ts +10 -0
- package/dist/tools/query.d.ts.map +1 -0
- package/dist/tools/query.js +188 -0
- package/dist/tools/query.js.map +1 -0
- package/package.json +53 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bq-metadata.js","sourceRoot":"","sources":["../../src/tools/bq-metadata.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* bq_query Tool
|
|
3
|
+
* BigQuery 데이터 쿼리 및 인사이트 생성
|
|
4
|
+
*/
|
|
5
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
6
|
+
/**
|
|
7
|
+
* bq_query Tool 등록
|
|
8
|
+
*/
|
|
9
|
+
export declare function registerBQQuery(server: McpServer): void;
|
|
10
|
+
//# sourceMappingURL=bq-query.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bq-query.d.ts","sourceRoot":"","sources":["../../src/tools/bq-query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0FzE;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqDvD"}
|
|
@@ -0,0 +1,357 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* bq_query Tool
|
|
3
|
+
* BigQuery 데이터 쿼리 및 인사이트 생성
|
|
4
|
+
*/
|
|
5
|
+
import { z } from "zod";
|
|
6
|
+
import { BigQueryClient, BigQueryError, } from "../bigquery/index.js";
|
|
7
|
+
// WHERE 연산자 스키마
|
|
8
|
+
const whereConditionSchema = z.object({
|
|
9
|
+
field: z.string().describe("필드명"),
|
|
10
|
+
operator: z
|
|
11
|
+
.enum([
|
|
12
|
+
"EQUALS",
|
|
13
|
+
"NOT_EQUALS",
|
|
14
|
+
"GREATER_THAN",
|
|
15
|
+
"LESS_THAN",
|
|
16
|
+
"GREATER_THAN_OR_EQUALS",
|
|
17
|
+
"LESS_THAN_OR_EQUALS",
|
|
18
|
+
"LIKE",
|
|
19
|
+
"IN",
|
|
20
|
+
"NOT_IN",
|
|
21
|
+
"IS_NULL",
|
|
22
|
+
"IS_NOT_NULL",
|
|
23
|
+
"BETWEEN",
|
|
24
|
+
])
|
|
25
|
+
.describe("비교 연산자"),
|
|
26
|
+
value: z
|
|
27
|
+
.union([
|
|
28
|
+
z.string(),
|
|
29
|
+
z.number(),
|
|
30
|
+
z.boolean(),
|
|
31
|
+
z.array(z.string()),
|
|
32
|
+
z.array(z.number()),
|
|
33
|
+
z.tuple([z.number(), z.number()]),
|
|
34
|
+
])
|
|
35
|
+
.describe("비교 값 (BETWEEN은 [start, end] 배열)"),
|
|
36
|
+
});
|
|
37
|
+
// 집계 함수 스키마
|
|
38
|
+
const aggregationSchema = z.object({
|
|
39
|
+
function: z
|
|
40
|
+
.enum(["COUNT", "SUM", "AVG", "MIN", "MAX", "COUNT_DISTINCT"])
|
|
41
|
+
.describe("집계 함수"),
|
|
42
|
+
field: z.string().describe("집계 대상 필드 (* 가능)"),
|
|
43
|
+
alias: z.string().describe("결과 컬럼 별칭"),
|
|
44
|
+
});
|
|
45
|
+
// 정렬 스키마
|
|
46
|
+
const orderBySchema = z.object({
|
|
47
|
+
field: z.string().describe("정렬 기준 필드"),
|
|
48
|
+
direction: z
|
|
49
|
+
.enum(["ASC", "DESC"])
|
|
50
|
+
.optional()
|
|
51
|
+
.describe("정렬 방향 (기본: DESC)"),
|
|
52
|
+
});
|
|
53
|
+
// 입력 스키마 정의
|
|
54
|
+
const bqQueryInputSchema = {
|
|
55
|
+
datasetId: z.string().describe("데이터셋 ID"),
|
|
56
|
+
tableId: z.string().describe("테이블 ID"),
|
|
57
|
+
columns: z
|
|
58
|
+
.array(z.string())
|
|
59
|
+
.optional()
|
|
60
|
+
.describe("조회할 컬럼 (기본: *)"),
|
|
61
|
+
where: z
|
|
62
|
+
.array(whereConditionSchema)
|
|
63
|
+
.optional()
|
|
64
|
+
.describe("WHERE 조건 (AND로 연결)"),
|
|
65
|
+
groupBy: z
|
|
66
|
+
.array(z.string())
|
|
67
|
+
.optional()
|
|
68
|
+
.describe("GROUP BY 컬럼"),
|
|
69
|
+
orderBy: z
|
|
70
|
+
.array(orderBySchema)
|
|
71
|
+
.optional()
|
|
72
|
+
.describe("ORDER BY 조건"),
|
|
73
|
+
aggregations: z
|
|
74
|
+
.array(aggregationSchema)
|
|
75
|
+
.optional()
|
|
76
|
+
.describe("집계 함수 (COUNT, SUM, AVG 등)"),
|
|
77
|
+
limit: z
|
|
78
|
+
.number()
|
|
79
|
+
.min(1)
|
|
80
|
+
.max(10000)
|
|
81
|
+
.optional()
|
|
82
|
+
.describe("결과 행 수 (기본: 100, 최대: 10000)"),
|
|
83
|
+
};
|
|
84
|
+
/**
|
|
85
|
+
* bq_query Tool 등록
|
|
86
|
+
*/
|
|
87
|
+
export function registerBQQuery(server) {
|
|
88
|
+
server.tool("bq_query", "BigQuery 테이블을 조회합니다. 파라미터 기반으로 SELECT 쿼리를 실행하고 인사이트를 생성합니다.", bqQueryInputSchema, async (params) => {
|
|
89
|
+
try {
|
|
90
|
+
const client = new BigQueryClient();
|
|
91
|
+
// 요청 구성
|
|
92
|
+
const request = {
|
|
93
|
+
datasetId: params.datasetId,
|
|
94
|
+
tableId: params.tableId,
|
|
95
|
+
columns: params.columns,
|
|
96
|
+
where: params.where,
|
|
97
|
+
groupBy: params.groupBy,
|
|
98
|
+
orderBy: params.orderBy,
|
|
99
|
+
aggregations: params.aggregations,
|
|
100
|
+
limit: params.limit || 100,
|
|
101
|
+
};
|
|
102
|
+
// 쿼리 실행
|
|
103
|
+
const response = await client.runQuery(request);
|
|
104
|
+
// 인사이트 생성
|
|
105
|
+
const insight = renderBigQueryInsight(response, request);
|
|
106
|
+
// 결과 포맷팅
|
|
107
|
+
const resultText = formatBQQueryResult(insight, response);
|
|
108
|
+
return {
|
|
109
|
+
content: [{ type: "text", text: resultText }],
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
catch (error) {
|
|
113
|
+
const errorMessage = error instanceof BigQueryError
|
|
114
|
+
? `[${error.code}] ${error.message}`
|
|
115
|
+
: error instanceof Error
|
|
116
|
+
? error.message
|
|
117
|
+
: String(error);
|
|
118
|
+
return {
|
|
119
|
+
content: [
|
|
120
|
+
{
|
|
121
|
+
type: "text",
|
|
122
|
+
text: `BigQuery 쿼리 오류: ${errorMessage}`,
|
|
123
|
+
},
|
|
124
|
+
],
|
|
125
|
+
isError: true,
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* BigQuery 인사이트 생성
|
|
132
|
+
*/
|
|
133
|
+
function renderBigQueryInsight(response, request) {
|
|
134
|
+
const { headers, rows, totalRows, bytesProcessed, cacheHit } = response;
|
|
135
|
+
// TL;DR 생성
|
|
136
|
+
const tldr = generateBQTldr(response, request);
|
|
137
|
+
// 테이블 데이터 변환
|
|
138
|
+
const data = {
|
|
139
|
+
headers,
|
|
140
|
+
rows: rows.map((row) => headers.map((h) => {
|
|
141
|
+
const val = row[h];
|
|
142
|
+
if (val === null || val === undefined)
|
|
143
|
+
return null;
|
|
144
|
+
if (typeof val === "object")
|
|
145
|
+
return JSON.stringify(val);
|
|
146
|
+
return val;
|
|
147
|
+
})),
|
|
148
|
+
};
|
|
149
|
+
// 인사이트 생성
|
|
150
|
+
const insights = generateBQInsights(response, request);
|
|
151
|
+
// 다음 액션 제안
|
|
152
|
+
const nextActions = suggestBQNextActions(response, request);
|
|
153
|
+
return {
|
|
154
|
+
tldr,
|
|
155
|
+
data,
|
|
156
|
+
insights,
|
|
157
|
+
nextActions,
|
|
158
|
+
meta: {
|
|
159
|
+
bytesProcessed,
|
|
160
|
+
cacheHit,
|
|
161
|
+
rowCount: totalRows,
|
|
162
|
+
},
|
|
163
|
+
};
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* TL;DR 생성
|
|
167
|
+
*/
|
|
168
|
+
function generateBQTldr(response, request) {
|
|
169
|
+
const { rows, totalRows } = response;
|
|
170
|
+
if (rows.length === 0) {
|
|
171
|
+
return `${request.datasetId}.${request.tableId} 테이블에서 조건에 맞는 데이터가 없습니다.`;
|
|
172
|
+
}
|
|
173
|
+
const parts = [];
|
|
174
|
+
parts.push(`${request.datasetId}.${request.tableId}`);
|
|
175
|
+
parts.push(`총 ${totalRows}개 행`);
|
|
176
|
+
// 집계 결과가 있으면 첫 번째 값 표시
|
|
177
|
+
if (request.aggregations?.length && rows.length > 0) {
|
|
178
|
+
const firstAgg = request.aggregations[0];
|
|
179
|
+
const value = rows[0][firstAgg.alias];
|
|
180
|
+
if (value !== undefined) {
|
|
181
|
+
parts.push(`${firstAgg.alias}: ${formatValue(value)}`);
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
return parts.join(" | ");
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* 인사이트 생성
|
|
188
|
+
*/
|
|
189
|
+
function generateBQInsights(response, request) {
|
|
190
|
+
const insights = [];
|
|
191
|
+
const { rows, headers } = response;
|
|
192
|
+
if (rows.length === 0) {
|
|
193
|
+
insights.push("조건에 맞는 데이터가 없습니다. 필터 조건을 확인해주세요.");
|
|
194
|
+
return insights;
|
|
195
|
+
}
|
|
196
|
+
// 숫자 컬럼 분석
|
|
197
|
+
const numericColumns = headers.filter((h) => {
|
|
198
|
+
const firstVal = rows[0]?.[h];
|
|
199
|
+
return typeof firstVal === "number";
|
|
200
|
+
});
|
|
201
|
+
numericColumns.forEach((col) => {
|
|
202
|
+
const values = rows
|
|
203
|
+
.map((r) => r[col])
|
|
204
|
+
.filter((v) => typeof v === "number");
|
|
205
|
+
if (values.length > 1) {
|
|
206
|
+
const sum = values.reduce((a, b) => a + b, 0);
|
|
207
|
+
const avg = sum / values.length;
|
|
208
|
+
const max = Math.max(...values);
|
|
209
|
+
const min = Math.min(...values);
|
|
210
|
+
// 상위 3개 기여도
|
|
211
|
+
if (request.groupBy?.length && rows.length >= 3) {
|
|
212
|
+
const top3Sum = values.slice(0, 3).reduce((a, b) => a + b, 0);
|
|
213
|
+
const contribution = (top3Sum / sum) * 100;
|
|
214
|
+
if (contribution > 50) {
|
|
215
|
+
insights.push(`상위 3개 항목이 ${col}의 ${contribution.toFixed(1)}%를 차지합니다.`);
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
// 이상치 탐지
|
|
219
|
+
if (max > avg * 3) {
|
|
220
|
+
insights.push(`${col} 컬럼에서 평균(${formatValue(avg)}) 대비 높은 값(${formatValue(max)})이 발견되었습니다.`);
|
|
221
|
+
}
|
|
222
|
+
if (min < avg * 0.1 && min > 0) {
|
|
223
|
+
insights.push(`${col} 컬럼에서 평균 대비 매우 낮은 값(${formatValue(min)})이 있습니다.`);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
});
|
|
227
|
+
// 기본 인사이트
|
|
228
|
+
if (insights.length === 0) {
|
|
229
|
+
insights.push(`총 ${rows.length}개의 데이터가 조회되었습니다.`);
|
|
230
|
+
}
|
|
231
|
+
return insights.slice(0, 5);
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* 다음 액션 제안
|
|
235
|
+
*/
|
|
236
|
+
function suggestBQNextActions(response, request) {
|
|
237
|
+
const actions = [];
|
|
238
|
+
// GROUP BY가 없으면 집계 제안
|
|
239
|
+
if (!request.groupBy?.length && !request.aggregations?.length) {
|
|
240
|
+
actions.push("집계 함수(COUNT, SUM, AVG)를 사용하여 데이터를 요약해보세요.");
|
|
241
|
+
}
|
|
242
|
+
// 결과가 limit에 도달했으면 필터 강화 제안
|
|
243
|
+
if (response.rows.length === (request.limit || 100)) {
|
|
244
|
+
actions.push("결과가 limit에 도달했습니다. WHERE 조건을 추가하거나 limit을 늘려보세요.");
|
|
245
|
+
}
|
|
246
|
+
// 캐시 미스면 쿼리 최적화 제안
|
|
247
|
+
if (response.cacheHit === false && (response.bytesProcessed || 0) > 1e9) {
|
|
248
|
+
actions.push(`${formatBytes(response.bytesProcessed || 0)} 스캔됨. 파티션 필터나 컬럼 선택으로 비용을 줄일 수 있습니다.`);
|
|
249
|
+
}
|
|
250
|
+
// 기본 제안
|
|
251
|
+
if (actions.length === 0) {
|
|
252
|
+
actions.push("다른 테이블과 JOIN하거나 시계열 분석을 해보세요.");
|
|
253
|
+
}
|
|
254
|
+
return actions.slice(0, 3);
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* 쿼리 결과 포맷팅
|
|
258
|
+
*/
|
|
259
|
+
function formatBQQueryResult(insight, response) {
|
|
260
|
+
const lines = [];
|
|
261
|
+
// TL;DR
|
|
262
|
+
lines.push("## 요약");
|
|
263
|
+
lines.push(insight.tldr);
|
|
264
|
+
lines.push("");
|
|
265
|
+
// 테이블
|
|
266
|
+
lines.push("## 데이터");
|
|
267
|
+
lines.push(formatMarkdownTable(insight.data.headers, insight.data.rows));
|
|
268
|
+
lines.push("");
|
|
269
|
+
// 인사이트
|
|
270
|
+
if (insight.insights.length > 0) {
|
|
271
|
+
lines.push("## 인사이트");
|
|
272
|
+
insight.insights.forEach((i, idx) => {
|
|
273
|
+
lines.push(`${idx + 1}. ${i}`);
|
|
274
|
+
});
|
|
275
|
+
lines.push("");
|
|
276
|
+
}
|
|
277
|
+
// 다음 액션
|
|
278
|
+
if (insight.nextActions.length > 0) {
|
|
279
|
+
lines.push("## 추가 분석 제안");
|
|
280
|
+
insight.nextActions.forEach((a) => {
|
|
281
|
+
lines.push(`- ${a}`);
|
|
282
|
+
});
|
|
283
|
+
lines.push("");
|
|
284
|
+
}
|
|
285
|
+
// 메타 정보
|
|
286
|
+
lines.push("---");
|
|
287
|
+
lines.push(`행 수: ${insight.meta.rowCount}`);
|
|
288
|
+
if (insight.meta.bytesProcessed) {
|
|
289
|
+
lines.push(`스캔량: ${formatBytes(insight.meta.bytesProcessed)}`);
|
|
290
|
+
}
|
|
291
|
+
if (insight.meta.cacheHit !== undefined) {
|
|
292
|
+
lines.push(`캐시: ${insight.meta.cacheHit ? "적중" : "미스"}`);
|
|
293
|
+
}
|
|
294
|
+
return lines.join("\n");
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
* Markdown 테이블 생성
|
|
298
|
+
*/
|
|
299
|
+
function formatMarkdownTable(headers, rows) {
|
|
300
|
+
if (rows.length === 0) {
|
|
301
|
+
return "(데이터 없음)";
|
|
302
|
+
}
|
|
303
|
+
const lines = [];
|
|
304
|
+
// 헤더
|
|
305
|
+
lines.push("| " + headers.join(" | ") + " |");
|
|
306
|
+
lines.push("| " + headers.map(() => "---").join(" | ") + " |");
|
|
307
|
+
// 행 (최대 20개만 표시)
|
|
308
|
+
const displayRows = rows.slice(0, 20);
|
|
309
|
+
displayRows.forEach((row) => {
|
|
310
|
+
const formattedRow = row.map((cell) => {
|
|
311
|
+
if (cell === null || cell === undefined)
|
|
312
|
+
return "-";
|
|
313
|
+
if (typeof cell === "number") {
|
|
314
|
+
return cell % 1 === 0 ? cell.toLocaleString() : cell.toFixed(2);
|
|
315
|
+
}
|
|
316
|
+
if (typeof cell === "boolean")
|
|
317
|
+
return cell ? "true" : "false";
|
|
318
|
+
// 긴 문자열 잘라내기
|
|
319
|
+
const str = String(cell);
|
|
320
|
+
return str.length > 50 ? str.substring(0, 47) + "..." : str;
|
|
321
|
+
});
|
|
322
|
+
lines.push("| " + formattedRow.join(" | ") + " |");
|
|
323
|
+
});
|
|
324
|
+
if (rows.length > 20) {
|
|
325
|
+
lines.push(`\n... 외 ${rows.length - 20}개 행`);
|
|
326
|
+
}
|
|
327
|
+
return lines.join("\n");
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* 값 포맷팅
|
|
331
|
+
*/
|
|
332
|
+
function formatValue(value) {
|
|
333
|
+
if (value === null || value === undefined)
|
|
334
|
+
return "-";
|
|
335
|
+
if (typeof value === "number") {
|
|
336
|
+
if (value >= 1e9)
|
|
337
|
+
return (value / 1e9).toFixed(1) + "B";
|
|
338
|
+
if (value >= 1e6)
|
|
339
|
+
return (value / 1e6).toFixed(1) + "M";
|
|
340
|
+
if (value >= 1e3)
|
|
341
|
+
return (value / 1e3).toFixed(1) + "K";
|
|
342
|
+
return value % 1 === 0 ? value.toLocaleString() : value.toFixed(2);
|
|
343
|
+
}
|
|
344
|
+
return String(value);
|
|
345
|
+
}
|
|
346
|
+
/**
|
|
347
|
+
* 바이트 크기 포맷팅
|
|
348
|
+
*/
|
|
349
|
+
function formatBytes(bytes) {
|
|
350
|
+
if (bytes === 0)
|
|
351
|
+
return "0 B";
|
|
352
|
+
const k = 1024;
|
|
353
|
+
const sizes = ["B", "KB", "MB", "GB", "TB"];
|
|
354
|
+
const i = Math.floor(Math.log(bytes) / Math.log(k));
|
|
355
|
+
return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + " " + sizes[i];
|
|
356
|
+
}
|
|
357
|
+
//# sourceMappingURL=bq-query.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bq-query.js","sourceRoot":"","sources":["../../src/tools/bq-query.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ga4_metadata & ga4_status Tools
|
|
3
|
+
* GA4 메타데이터 및 연결 상태 확인
|
|
4
|
+
*/
|
|
5
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
6
|
+
/**
|
|
7
|
+
* ga4_metadata Tool 등록
|
|
8
|
+
* 사용 가능한 지표와 차원 목록 제공
|
|
9
|
+
*/
|
|
10
|
+
export declare function registerGA4Metadata(server: McpServer): void;
|
|
11
|
+
//# sourceMappingURL=metadata.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/tools/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoG3D"}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ga4_metadata & ga4_status Tools
|
|
3
|
+
* GA4 메타데이터 및 연결 상태 확인
|
|
4
|
+
*/
|
|
5
|
+
import { z } from "zod";
|
|
6
|
+
import { GA4Client, GA4Error, SUPPORTED_METRICS, SUPPORTED_DIMENSIONS, } from "../ga4/index.js";
|
|
7
|
+
/**
|
|
8
|
+
* ga4_metadata Tool 등록
|
|
9
|
+
* 사용 가능한 지표와 차원 목록 제공
|
|
10
|
+
*/
|
|
11
|
+
export function registerGA4Metadata(server) {
|
|
12
|
+
// ga4_metadata: 지표/차원 목록
|
|
13
|
+
server.tool("ga4_metadata", "GA4에서 사용 가능한 지표(metrics)와 차원(dimensions) 목록을 확인합니다.", {
|
|
14
|
+
filter: z
|
|
15
|
+
.string()
|
|
16
|
+
.optional()
|
|
17
|
+
.describe("필터 키워드 (예: session, user, page)"),
|
|
18
|
+
}, async (params) => {
|
|
19
|
+
const filter = params.filter?.toLowerCase();
|
|
20
|
+
let metrics = [...SUPPORTED_METRICS];
|
|
21
|
+
let dimensions = [...SUPPORTED_DIMENSIONS];
|
|
22
|
+
if (filter) {
|
|
23
|
+
metrics = metrics.filter((m) => m.toLowerCase().includes(filter));
|
|
24
|
+
dimensions = dimensions.filter((d) => d.toLowerCase().includes(filter));
|
|
25
|
+
}
|
|
26
|
+
const lines = [];
|
|
27
|
+
lines.push("## 지원되는 지표 (Metrics)");
|
|
28
|
+
lines.push("");
|
|
29
|
+
metrics.forEach((m) => {
|
|
30
|
+
lines.push(`- \`${m}\`: ${getMetricDescription(m)}`);
|
|
31
|
+
});
|
|
32
|
+
lines.push("");
|
|
33
|
+
lines.push("## 지원되는 차원 (Dimensions)");
|
|
34
|
+
lines.push("");
|
|
35
|
+
dimensions.forEach((d) => {
|
|
36
|
+
lines.push(`- \`${d}\`: ${getDimensionDescription(d)}`);
|
|
37
|
+
});
|
|
38
|
+
lines.push("");
|
|
39
|
+
lines.push("---");
|
|
40
|
+
lines.push("전체 목록은 GA4 API 문서를 참조하세요:");
|
|
41
|
+
lines.push("https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema");
|
|
42
|
+
return {
|
|
43
|
+
content: [
|
|
44
|
+
{
|
|
45
|
+
type: "text",
|
|
46
|
+
text: lines.join("\n"),
|
|
47
|
+
},
|
|
48
|
+
],
|
|
49
|
+
};
|
|
50
|
+
});
|
|
51
|
+
// ga4_status: 연결 상태 확인
|
|
52
|
+
server.tool("ga4_status", "GA4 연결 상태를 확인합니다. API 연결 테스트 및 설정 정보를 반환합니다.", {}, async () => {
|
|
53
|
+
try {
|
|
54
|
+
const client = new GA4Client();
|
|
55
|
+
const result = await client.testConnection();
|
|
56
|
+
const lines = [];
|
|
57
|
+
lines.push("## GA4 연결 상태");
|
|
58
|
+
lines.push("");
|
|
59
|
+
lines.push(`- **상태**: ${result.success ? "✅ 연결됨" : "❌ 연결 실패"}`);
|
|
60
|
+
lines.push(`- **메시지**: ${result.message}`);
|
|
61
|
+
lines.push(`- **Property ID**: ${client.getPropertyId()}`);
|
|
62
|
+
return {
|
|
63
|
+
content: [
|
|
64
|
+
{
|
|
65
|
+
type: "text",
|
|
66
|
+
text: lines.join("\n"),
|
|
67
|
+
},
|
|
68
|
+
],
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
const message = error instanceof GA4Error
|
|
73
|
+
? error.message
|
|
74
|
+
: error instanceof Error
|
|
75
|
+
? error.message
|
|
76
|
+
: String(error);
|
|
77
|
+
return {
|
|
78
|
+
content: [
|
|
79
|
+
{
|
|
80
|
+
type: "text",
|
|
81
|
+
text: `GA4 연결 확인 실패: ${message}`,
|
|
82
|
+
},
|
|
83
|
+
],
|
|
84
|
+
isError: true,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* 지표 설명
|
|
91
|
+
*/
|
|
92
|
+
function getMetricDescription(metric) {
|
|
93
|
+
const descriptions = {
|
|
94
|
+
sessions: "세션 수",
|
|
95
|
+
totalUsers: "전체 사용자 수",
|
|
96
|
+
newUsers: "신규 사용자 수",
|
|
97
|
+
activeUsers: "활성 사용자 수",
|
|
98
|
+
engagedSessions: "참여 세션 수 (10초 이상 또는 전환 발생)",
|
|
99
|
+
engagementRate: "참여율 (참여 세션 / 전체 세션)",
|
|
100
|
+
averageSessionDuration: "평균 세션 시간 (초)",
|
|
101
|
+
screenPageViews: "페이지뷰 수",
|
|
102
|
+
screenPageViewsPerSession: "세션당 페이지뷰",
|
|
103
|
+
bounceRate: "이탈률",
|
|
104
|
+
conversions: "전환 수 (key event)",
|
|
105
|
+
eventCount: "이벤트 발생 수",
|
|
106
|
+
eventsPerSession: "세션당 이벤트 수",
|
|
107
|
+
};
|
|
108
|
+
return descriptions[metric] || metric;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* 차원 설명
|
|
112
|
+
*/
|
|
113
|
+
function getDimensionDescription(dimension) {
|
|
114
|
+
const descriptions = {
|
|
115
|
+
date: "날짜 (YYYYMMDD)",
|
|
116
|
+
dateHour: "날짜+시간 (YYYYMMDDHH)",
|
|
117
|
+
sessionDefaultChannelGroup: "기본 채널 그룹",
|
|
118
|
+
sessionSource: "트래픽 소스",
|
|
119
|
+
sessionMedium: "트래픽 매체",
|
|
120
|
+
sessionSourceMedium: "소스/매체 조합",
|
|
121
|
+
sessionCampaignName: "캠페인 이름",
|
|
122
|
+
landingPage: "랜딩 페이지 경로",
|
|
123
|
+
landingPagePlusQueryString: "랜딩 페이지 (쿼리스트링 포함)",
|
|
124
|
+
pagePath: "페이지 경로",
|
|
125
|
+
pageTitle: "페이지 제목",
|
|
126
|
+
eventName: "이벤트 이름",
|
|
127
|
+
deviceCategory: "디바이스 유형 (desktop, mobile, tablet)",
|
|
128
|
+
operatingSystem: "운영체제",
|
|
129
|
+
browser: "브라우저",
|
|
130
|
+
country: "국가",
|
|
131
|
+
city: "도시",
|
|
132
|
+
};
|
|
133
|
+
return descriptions[dimension] || dimension;
|
|
134
|
+
}
|
|
135
|
+
//# sourceMappingURL=metadata.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/tools/metadata.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ga4_query Tool
|
|
3
|
+
* GA4 데이터 쿼리 및 인사이트 생성
|
|
4
|
+
*/
|
|
5
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
6
|
+
/**
|
|
7
|
+
* ga4_query Tool 등록
|
|
8
|
+
*/
|
|
9
|
+
export declare function registerGA4Query(server: McpServer): void;
|
|
10
|
+
//# sourceMappingURL=query.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0DzE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkFxD"}
|