@pushizo/mcp-server 0.2.0 → 0.4.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 +24 -4
- package/dist/api.d.ts +1 -1
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js.map +1 -1
- package/dist/credential-files.d.ts +103 -0
- package/dist/credential-files.d.ts.map +1 -0
- package/dist/credential-files.js +318 -0
- package/dist/credential-files.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/kit.d.ts +6 -0
- package/dist/kit.d.ts.map +1 -1
- package/dist/kit.js +21 -15
- package/dist/kit.js.map +1 -1
- package/dist/server.d.ts +11 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +47 -29
- package/dist/server.js.map +1 -1
- package/dist/stdio.js +6 -3
- package/dist/stdio.js.map +1 -1
- package/dist/tools-data.d.ts +13 -0
- package/dist/tools-data.d.ts.map +1 -0
- package/dist/tools-data.js +223 -0
- package/dist/tools-data.js.map +1 -0
- package/dist/tools-engage.d.ts +11 -0
- package/dist/tools-engage.d.ts.map +1 -0
- package/dist/tools-engage.js +226 -0
- package/dist/tools-engage.js.map +1 -0
- package/dist/tools-insights.js +62 -62
- package/dist/tools-insights.js.map +1 -1
- package/dist/tools-ops.d.ts +11 -0
- package/dist/tools-ops.d.ts.map +1 -0
- package/dist/tools-ops.js +96 -0
- package/dist/tools-ops.js.map +1 -0
- package/dist/tools-read.d.ts.map +1 -1
- package/dist/tools-read.js +59 -64
- package/dist/tools-read.js.map +1 -1
- package/dist/tools-setup.d.ts +15 -0
- package/dist/tools-setup.d.ts.map +1 -0
- package/dist/tools-setup.js +128 -0
- package/dist/tools-setup.js.map +1 -0
- package/dist/tools-write.d.ts +3 -3
- package/dist/tools-write.d.ts.map +1 -1
- package/dist/tools-write.js +101 -24
- package/dist/tools-write.js.map +1 -1
- package/package.json +3 -3
- package/server.json +9 -3
package/dist/kit.js
CHANGED
|
@@ -4,24 +4,30 @@ import { PushizoApiError } from './api.js';
|
|
|
4
4
|
export const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
|
|
5
5
|
/** Yazma araçları: yalnızca taslak oluşturur (gönderim/silme yok), sunucuda `mcp:write` kapsamı zorunlu. */
|
|
6
6
|
export const WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
|
|
7
|
-
export const WRITE_NOTE = '[
|
|
8
|
-
'API
|
|
7
|
+
export const WRITE_NOTE = '[Approved mode — write] This tool creates a record in Pushizo. It only creates a DRAFT and never sends or schedules a message; ' +
|
|
8
|
+
'the API key needs the `mcp:write` scope. Get explicit approval from the user before calling it.';
|
|
9
9
|
/**
|
|
10
10
|
* Kimlikler URL yoluna yazılır: `.` ve `..` WHATWG URL çözümlemesinde başka uca kayar, `/` yolu böler. Desen bunları
|
|
11
11
|
* dışarıda bırakır (ADR-0076 §5).
|
|
12
12
|
*/
|
|
13
13
|
const ID_PATTERN = /^(?!\.{1,2}$)[A-Za-z0-9_.:-]+$/;
|
|
14
|
-
const ID_MESSAGE = '
|
|
15
|
-
export const appIdArg = z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).optional().describe('App
|
|
16
|
-
export const limitArg = z.number().int().min(1).max(100).optional().describe('
|
|
17
|
-
export const cursorArg = z.string().max(500).optional().describe('
|
|
18
|
-
export const idArg = (what) => z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).describe(`${what}
|
|
19
|
-
export const fromArg = z.string().max(40).optional().describe('ISO-8601
|
|
20
|
-
export const toArg = z.string().max(40).optional().describe('ISO-8601
|
|
14
|
+
const ID_MESSAGE = 'ID may only contain letters, digits, `_`, `-`, `.` and `:`.';
|
|
15
|
+
export const appIdArg = z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).optional().describe('App ID (app_…). Not needed with an app-scoped key or when a default app is configured.');
|
|
16
|
+
export const limitArg = z.number().int().min(1).max(100).optional().describe('Page size (default 20).');
|
|
17
|
+
export const cursorArg = z.string().max(500).optional().describe('The `next_cursor` value from the previous response.');
|
|
18
|
+
export const idArg = (what) => z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).describe(`${what} ID`);
|
|
19
|
+
export const fromArg = z.string().max(40).optional().describe('ISO-8601 start (e.g. 2026-10-01T00:00:00Z); defaults to the report default.');
|
|
20
|
+
export const toArg = z.string().max(40).optional().describe('ISO-8601 end.');
|
|
21
|
+
/** Kullanıcıyı kimlik etiketiyle seçen ortak argümanlar (`/users/by/{label}/{value}` uçları). */
|
|
22
|
+
export const aliasArgs = {
|
|
23
|
+
label: z.string().min(1).max(64).describe('Identity label: `external_id`, `pushizo_id` or a defined alias (e.g. `crm_id`).'),
|
|
24
|
+
value: z.string().min(1).max(255).describe('Value for the label (e.g. the external_id value).'),
|
|
25
|
+
};
|
|
26
|
+
export const compareArg = z.boolean().optional().describe('true: adds a comparison with the previous period of equal length.');
|
|
21
27
|
/** Segment/arama tanımı: all/any/none koşul grupları (segment taslağıyla aynı biçim). */
|
|
22
28
|
export const definitionArg = z
|
|
23
29
|
.record(z.string(), z.unknown())
|
|
24
|
-
.describe('
|
|
30
|
+
.describe('Condition definition, e.g. {"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.');
|
|
25
31
|
export function query(params) {
|
|
26
32
|
const q = new URLSearchParams();
|
|
27
33
|
for (const [k, v] of Object.entries(params))
|
|
@@ -35,15 +41,15 @@ export function ok(data) {
|
|
|
35
41
|
}
|
|
36
42
|
/** Sık görülen durum kodları için modelin sonraki adımını belirleyen ipucu. */
|
|
37
43
|
const HTTP_HINTS = {
|
|
38
|
-
403: ' —
|
|
39
|
-
429: ' —
|
|
44
|
+
403: ' — Check the API key scopes.',
|
|
45
|
+
429: ' — Rate limited; wait a few seconds and retry, and reduce back-to-back calls.',
|
|
40
46
|
};
|
|
41
47
|
export function fail(err) {
|
|
42
48
|
const text = err instanceof PushizoApiError
|
|
43
49
|
? `${err.code} (HTTP ${err.status}): ${err.message}${HTTP_HINTS[err.status] ?? ''}`
|
|
44
50
|
: err instanceof Error
|
|
45
51
|
? err.name === 'TimeoutError' || err.name === 'AbortError'
|
|
46
|
-
? '
|
|
52
|
+
? 'Request timed out; retry with a narrower date range or a smaller `limit`.'
|
|
47
53
|
: err.message
|
|
48
54
|
: String(err);
|
|
49
55
|
return { isError: true, content: [{ type: 'text', text }] };
|
|
@@ -52,7 +58,7 @@ export function createToolKit(api, defaultAppId) {
|
|
|
52
58
|
function app(appId) {
|
|
53
59
|
const id = appId ?? defaultAppId;
|
|
54
60
|
if (!id)
|
|
55
|
-
throw new Error('app_id
|
|
61
|
+
throw new Error('app_id is required (pass app_id in the tool call when the key is organization-wide).');
|
|
56
62
|
return seg(id);
|
|
57
63
|
}
|
|
58
64
|
async function run(fn) {
|
|
@@ -71,7 +77,7 @@ export function createToolKit(api, defaultAppId) {
|
|
|
71
77
|
*/
|
|
72
78
|
export function seg(value) {
|
|
73
79
|
if (value === '.' || value === '..')
|
|
74
|
-
throw new Error('
|
|
80
|
+
throw new Error('Invalid value: `.` and `..` cannot be used as path segments.');
|
|
75
81
|
return encodeURIComponent(value);
|
|
76
82
|
}
|
|
77
83
|
//# sourceMappingURL=kit.js.map
|
package/dist/kit.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,IAAI,GAAoB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAChI,4GAA4G;AAC5G,MAAM,CAAC,MAAM,KAAK,GAAoB,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEnI,MAAM,CAAC,MAAM,UAAU,GACrB,
|
|
1
|
+
{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"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"}
|
package/dist/server.d.ts
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
2
|
import type { PushizoApi } from './api.js';
|
|
3
|
+
import type { CredentialHost } from './credential-files.js';
|
|
3
4
|
export declare const MCP_SERVER_NAME = "pushizo";
|
|
4
5
|
/** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
|
|
5
|
-
export declare const MCP_SERVER_VERSION = "0.
|
|
6
|
+
export declare const MCP_SERVER_VERSION = "0.4.0";
|
|
6
7
|
export interface PushizoMcpOptions {
|
|
7
8
|
api: PushizoApi;
|
|
8
9
|
/** Araçta `app_id` verilmezse kullanılan app (app'e bağlı anahtarda anahtarın app'i). */
|
|
@@ -12,12 +13,20 @@ export interface PushizoMcpOptions {
|
|
|
12
13
|
* Verilmezse (stdio) tüm araçlar listelenir; yetki her çağrıda yine sunucuda denetlenir.
|
|
13
14
|
*/
|
|
14
15
|
scopes?: readonly string[];
|
|
16
|
+
/**
|
|
17
|
+
* Yalnız yerel (stdio) süreçte verilir: anahtarı dosya yolundan yükleyen araç kaydedilir (ADR-0097). Uzak (HTTP)
|
|
18
|
+
* taşımada verilmez; sunucu kullanıcının dosya sistemini göremez.
|
|
19
|
+
*/
|
|
20
|
+
local?: CredentialHost;
|
|
15
21
|
}
|
|
16
22
|
/** Yazma araçları listelensin mi: kapsam bilinmiyorsa evet, biliniyorsa `mcp:write` veya `admin` gerekir. */
|
|
17
23
|
export declare function canListWriteTools(scopes: readonly string[] | undefined): boolean;
|
|
18
24
|
/**
|
|
19
25
|
* Pushizo MCP sunucusu (ADR-0031 §6, ADR-0043): segment, kampanya, mesaj, şablon, journey, kullanıcı, olay, analitik,
|
|
20
|
-
* in-app ve web büyüme okuma araçları;
|
|
26
|
+
* in-app ve web büyüme okuma araçları; veri (şirket, SQL, boru hattı, ambar) ve etkileşim (konuşma, AI ajanı, site
|
|
27
|
+
* araması, reklam) okuma araçları; kampanya/segment/şablon/journey/in-app/web kampanyası/web kişiselleştirme/anket/
|
|
28
|
+
* landing taslağı ve test cihazlarına test gönderimi; kurulum araçları (ADR-0097: app oluşturma, kurulum durumu, SDK kodu
|
|
29
|
+
* ve yalnız yerel süreçte anahtarı dosya yolundan yükleme).
|
|
21
30
|
* Taşıma bağımsızdır (stdio, Streamable HTTP, testte in-memory).
|
|
22
31
|
*/
|
|
23
32
|
export declare function createPushizoMcpServer(options: PushizoMcpOptions): McpServer;
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3C,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEhF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAuK5E"}
|
package/dist/server.js
CHANGED
|
@@ -1,34 +1,44 @@
|
|
|
1
1
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
2
|
import { z } from 'zod';
|
|
3
3
|
import { READ, WRITE, WRITE_NOTE, appIdArg, createToolKit, cursorArg, idArg, limitArg, query, seg } from './kit.js';
|
|
4
|
+
import { registerDataTools } from './tools-data.js';
|
|
5
|
+
import { registerEngageTools } from './tools-engage.js';
|
|
4
6
|
import { registerInsightTools } from './tools-insights.js';
|
|
7
|
+
import { registerOpsTools } from './tools-ops.js';
|
|
5
8
|
import { registerReadTools } from './tools-read.js';
|
|
9
|
+
import { registerLocalTools, registerSetupReadTools, registerSetupWriteTools } from './tools-setup.js';
|
|
6
10
|
import { registerWriteTools } from './tools-write.js';
|
|
7
11
|
export const MCP_SERVER_NAME = 'pushizo';
|
|
8
12
|
/** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
|
|
9
|
-
export const MCP_SERVER_VERSION = '0.
|
|
13
|
+
export const MCP_SERVER_VERSION = '0.4.0';
|
|
10
14
|
/** Yazma araçları listelensin mi: kapsam bilinmiyorsa evet, biliniyorsa `mcp:write` veya `admin` gerekir. */
|
|
11
15
|
export function canListWriteTools(scopes) {
|
|
12
16
|
return !scopes || scopes.includes('admin') || scopes.includes('mcp:write');
|
|
13
17
|
}
|
|
14
18
|
/**
|
|
15
19
|
* Pushizo MCP sunucusu (ADR-0031 §6, ADR-0043): segment, kampanya, mesaj, şablon, journey, kullanıcı, olay, analitik,
|
|
16
|
-
* in-app ve web büyüme okuma araçları;
|
|
20
|
+
* in-app ve web büyüme okuma araçları; veri (şirket, SQL, boru hattı, ambar) ve etkileşim (konuşma, AI ajanı, site
|
|
21
|
+
* araması, reklam) okuma araçları; kampanya/segment/şablon/journey/in-app/web kampanyası/web kişiselleştirme/anket/
|
|
22
|
+
* landing taslağı ve test cihazlarına test gönderimi; kurulum araçları (ADR-0097: app oluşturma, kurulum durumu, SDK kodu
|
|
23
|
+
* ve yalnız yerel süreçte anahtarı dosya yolundan yükleme).
|
|
17
24
|
* Taşıma bağımsızdır (stdio, Streamable HTTP, testte in-memory).
|
|
18
25
|
*/
|
|
19
26
|
export function createPushizoMcpServer(options) {
|
|
20
27
|
const server = new McpServer({ name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION, title: 'Pushizo' }, {
|
|
21
|
-
instructions: 'Pushizo
|
|
22
|
-
'test
|
|
23
|
-
'
|
|
28
|
+
instructions: 'Tools for the Pushizo messaging platform (push, email, SMS, in-app, journeys). Read tools are side-effect free. create_* tools only create drafts and ' +
|
|
29
|
+
'send_test_notification only sends to test devices; call either only after the user explicitly approves. This server cannot send to real audiences, ' +
|
|
30
|
+
'schedule, publish or delete; drafts are reviewed and sent from the Pushizo dashboard. For analysis, first find IDs with list_* tools, then use get_* and report tools. ' +
|
|
31
|
+
'To set Pushizo up in an app: create_app (after approval), get_sdk_snippet for the code, then the push credentials, then get_setup_status until the first subscriber arrives. ' +
|
|
32
|
+
'Never ask the user to paste a push key (.p8, .p12, service account JSON, client secret) into the chat and never read such a file yourself: on a local server pass its PATH to ' +
|
|
33
|
+
'upload_channel_credentials; otherwise give the user the dashboard link from get_setup_status.',
|
|
24
34
|
});
|
|
25
35
|
const kit = createToolKit(options.api, options.defaultAppId);
|
|
26
36
|
const { api, app, run } = kit;
|
|
27
|
-
server.registerTool('list_segments', { title: '
|
|
28
|
-
server.registerTool('get_segment', { title: '
|
|
37
|
+
server.registerTool('list_segments', { title: 'List segments', description: 'Lists the app’s segments (name search, pagination). Required scope: segments:read.', inputSchema: { app_id: appIdArg, q: z.string().max(100).optional(), limit: limitArg, cursor: cursorArg }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/segments${query({ q: a.q, limit: a.limit, cursor: a.cursor })}`)));
|
|
38
|
+
server.registerTool('get_segment', { title: 'Get segment', description: 'Segment definition and estimated audience size. Required scope: segments:read.', inputSchema: { app_id: appIdArg, segment_id: idArg('Segment') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/segments/${seg(a.segment_id)}`)));
|
|
29
39
|
server.registerTool('list_campaigns', {
|
|
30
|
-
title: '
|
|
31
|
-
description: '
|
|
40
|
+
title: 'List campaigns',
|
|
41
|
+
description: 'Lists campaigns (filter by status, type or name). Required scope: analytics:read.',
|
|
32
42
|
inputSchema: {
|
|
33
43
|
app_id: appIdArg,
|
|
34
44
|
q: z.string().max(100).optional(),
|
|
@@ -38,45 +48,45 @@ export function createPushizoMcpServer(options) {
|
|
|
38
48
|
},
|
|
39
49
|
annotations: READ,
|
|
40
50
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns${query({ q: a.q, status: a.status, limit: a.limit, cursor: a.cursor })}`)));
|
|
41
|
-
server.registerTool('get_campaign', { title: '
|
|
42
|
-
server.registerTool('list_campaign_messages', { title: '
|
|
51
|
+
server.registerTool('get_campaign', { title: 'Get campaign', description: 'Campaign details (audience, content, approval status, stats). Required scope: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id: idArg('Campaign') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns/${seg(a.campaign_id)}`)));
|
|
52
|
+
server.registerTool('list_campaign_messages', { title: 'Campaign runs', description: 'Messages of a campaign (one message per run) with their counters. Required scope: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id: idArg('Campaign') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns/${seg(a.campaign_id)}/messages`)));
|
|
43
53
|
server.registerTool('list_messages', {
|
|
44
|
-
title: '
|
|
45
|
-
description: '
|
|
54
|
+
title: 'List messages',
|
|
55
|
+
description: 'Sent messages (API, campaign, journey) with delivery counters. Required scope: analytics:read or notifications:write.',
|
|
46
56
|
inputSchema: { app_id: appIdArg, limit: limitArg, cursor: cursorArg },
|
|
47
57
|
annotations: READ,
|
|
48
58
|
}, async (a) => run(() => api.request('GET', `/v1/notifications${query({ app_id: decodeURIComponent(app(a.app_id)), limit: a.limit, cursor: a.cursor })}`)));
|
|
49
|
-
server.registerTool('get_message', { title: '
|
|
59
|
+
server.registerTool('get_message', { title: 'Get message', description: 'Message status and counters. Required scope: analytics:read or notifications:write.', inputSchema: { app_id: appIdArg, message_id: idArg('Message') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/notifications/${seg(a.message_id)}${query({ app_id: decodeURIComponent(app(a.app_id)) })}`)));
|
|
50
60
|
server.registerTool('get_analytics_summary', {
|
|
51
|
-
title: '
|
|
52
|
-
description: '
|
|
61
|
+
title: 'Analytics summary',
|
|
62
|
+
description: 'Overview KPIs: sends, deliveries, open/click rates, subscription growth (last 7/30 days or a custom range). Required scope: analytics:read.',
|
|
53
63
|
inputSchema: {
|
|
54
64
|
app_id: appIdArg,
|
|
55
65
|
range: z.enum(['7d', '30d']).optional(),
|
|
56
|
-
from: z.string().max(40).optional().describe('ISO-8601
|
|
57
|
-
to: z.string().max(40).optional().describe('ISO-8601
|
|
66
|
+
from: z.string().max(40).optional().describe('ISO-8601 start (use together with to)'),
|
|
67
|
+
to: z.string().max(40).optional().describe('ISO-8601 end'),
|
|
58
68
|
},
|
|
59
69
|
annotations: READ,
|
|
60
70
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/analytics/overview${query({ range: a.range, from: a.from, to: a.to })}`)));
|
|
61
71
|
server.registerTool('list_templates', {
|
|
62
|
-
title: '
|
|
63
|
-
description: '
|
|
72
|
+
title: 'List templates',
|
|
73
|
+
description: 'Message templates (filter by channel or name). Required scope: analytics:read.',
|
|
64
74
|
inputSchema: { app_id: appIdArg, q: z.string().max(100).optional(), channel: z.string().max(32).optional(), limit: limitArg, cursor: cursorArg },
|
|
65
75
|
annotations: READ,
|
|
66
76
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/templates${query({ q: a.q, channel: a.channel, limit: a.limit, cursor: a.cursor })}`)));
|
|
67
77
|
const writable = canListWriteTools(options.scopes);
|
|
68
78
|
if (writable) {
|
|
69
79
|
server.registerTool('create_campaign_draft', {
|
|
70
|
-
title: '
|
|
71
|
-
description: `${WRITE_NOTE}
|
|
72
|
-
'
|
|
80
|
+
title: 'Create campaign draft',
|
|
81
|
+
description: `${WRITE_NOTE} Creates a campaign in \`draft\` status. Audience is given as segment IDs; content inline or via template_id. ` +
|
|
82
|
+
'Example content: {"headings":{"en":"Title"},"contents":{"en":"Body"}}. Run run_campaign_preflight on the draft to audit it before a person sends it.',
|
|
73
83
|
inputSchema: {
|
|
74
84
|
app_id: appIdArg,
|
|
75
85
|
name: z.string().min(2).max(120),
|
|
76
|
-
included_segments: z.array(z.string().min(1).max(64)).max(20).optional().describe('
|
|
86
|
+
included_segments: z.array(z.string().min(1).max(64)).max(20).optional().describe('Included segments; empty means all subscribers.'),
|
|
77
87
|
excluded_segments: z.array(z.string().min(1).max(64)).max(20).optional(),
|
|
78
|
-
channels: z.array(z.string().max(32)).max(10).optional().describe('
|
|
79
|
-
content: z.record(z.string(), z.unknown()).optional().describe('
|
|
88
|
+
channels: z.array(z.string().max(32)).max(10).optional().describe('e.g. ["web_push","android_push","ios_push","email","sms"]'),
|
|
89
|
+
content: z.record(z.string(), z.unknown()).optional().describe('Message content (headings/contents/email_subject…).'),
|
|
80
90
|
template_id: z.string().max(64).optional(),
|
|
81
91
|
labels: z.array(z.string().min(1).max(40)).max(9).optional(),
|
|
82
92
|
},
|
|
@@ -93,22 +103,30 @@ export function createPushizoMcpServer(options) {
|
|
|
93
103
|
...(a.labels ? { labels: a.labels } : {}),
|
|
94
104
|
})));
|
|
95
105
|
server.registerTool('create_segment_draft', {
|
|
96
|
-
title: '
|
|
97
|
-
description: `${WRITE_NOTE}
|
|
106
|
+
title: 'Create segment draft',
|
|
107
|
+
description: `${WRITE_NOTE} Creates a dynamic segment (no effect until used in a campaign). Definition format: ` +
|
|
98
108
|
'{"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.',
|
|
99
109
|
inputSchema: {
|
|
100
110
|
app_id: appIdArg,
|
|
101
111
|
name: z.string().min(1).max(200),
|
|
102
112
|
description: z.string().max(500).optional(),
|
|
103
|
-
definition: z.record(z.string(), z.unknown()).describe('Segment
|
|
113
|
+
definition: z.record(z.string(), z.unknown()).describe('Segment definition (all/any/none condition groups).'),
|
|
104
114
|
},
|
|
105
115
|
annotations: WRITE,
|
|
106
116
|
}, async (a) => run(() => api.request('POST', `/v1/apps/${app(a.app_id)}/mcp/segment-drafts`, { name: a.name, ...(a.description ? { description: a.description } : {}), definition: a.definition })));
|
|
107
117
|
}
|
|
108
118
|
registerReadTools(server, kit);
|
|
109
119
|
registerInsightTools(server, kit);
|
|
120
|
+
registerDataTools(server, kit);
|
|
121
|
+
registerEngageTools(server, kit);
|
|
122
|
+
registerOpsTools(server, kit);
|
|
123
|
+
registerSetupReadTools(server, kit);
|
|
110
124
|
if (writable)
|
|
111
125
|
registerWriteTools(server, kit);
|
|
126
|
+
if (writable)
|
|
127
|
+
registerSetupWriteTools(server, kit);
|
|
128
|
+
if (writable && options.local)
|
|
129
|
+
registerLocalTools(server, kit, options.local);
|
|
112
130
|
return server;
|
|
113
131
|
}
|
|
114
132
|
//# sourceMappingURL=server.js.map
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/dist/stdio.js
CHANGED
|
@@ -7,22 +7,25 @@ import { createPushizoMcpServer } from './server.js';
|
|
|
7
7
|
* - `PUSHIZO_API_KEY` (zorunlu): `hs_live_…` API anahtarı (okuma kapsamları; taslak için `mcp:write`).
|
|
8
8
|
* - `PUSHIZO_API_URL` (varsayılan `https://api.pushizo.com`).
|
|
9
9
|
* - `PUSHIZO_APP_ID` (isteğe bağlı): araçlarda app_id verilmezse kullanılacak app.
|
|
10
|
+
* - `PUSHIZO_CREDENTIALS_DIR` (isteğe bağlı): `upload_channel_credentials` aracının dosya okuyabileceği kök dizin
|
|
11
|
+
* (varsayılan: sürecin çalışma dizini). Anahtar dosyaları yalnız bu dizinin altından okunur (ADR-0097).
|
|
10
12
|
* stdout yalnızca MCP iletileri içindir; tanılama stderr'e yazılır.
|
|
11
13
|
*/
|
|
12
14
|
const apiKey = process.env.PUSHIZO_API_KEY?.trim();
|
|
13
15
|
if (!apiKey) {
|
|
14
|
-
console.error('PUSHIZO_API_KEY
|
|
16
|
+
console.error('PUSHIZO_API_KEY is not set.');
|
|
15
17
|
process.exit(1);
|
|
16
18
|
}
|
|
17
19
|
const baseUrl = process.env.PUSHIZO_API_URL?.trim() || 'https://api.pushizo.com';
|
|
18
20
|
if (!/^https:\/\//.test(baseUrl) && !/^http:\/\/(localhost|127\.0\.0\.1)(:\d+)?(\/|$)/.test(baseUrl)) {
|
|
19
|
-
console.error('PUSHIZO_API_URL https
|
|
21
|
+
console.error('PUSHIZO_API_URL must use https (http://localhost is accepted for local development).');
|
|
20
22
|
process.exit(1);
|
|
21
23
|
}
|
|
22
24
|
const server = createPushizoMcpServer({
|
|
23
25
|
api: createFetchApi({ baseUrl, apiKey, userAgent: 'pushizo-mcp-stdio' }),
|
|
24
26
|
defaultAppId: process.env.PUSHIZO_APP_ID?.trim() || undefined,
|
|
27
|
+
local: { rootDir: process.env.PUSHIZO_CREDENTIALS_DIR?.trim() || process.cwd(), env: process.env },
|
|
25
28
|
});
|
|
26
29
|
await server.connect(new StdioServerTransport());
|
|
27
|
-
console.error(`Pushizo MCP
|
|
30
|
+
console.error(`Pushizo MCP server (stdio) ready: ${baseUrl}`);
|
|
28
31
|
//# sourceMappingURL=stdio.js.map
|
package/dist/stdio.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD
|
|
1
|
+
{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;AACnD,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,yBAAyB,CAAC;AACjF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACrG,OAAO,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;IACtG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,sBAAsB,CAAC;IACpC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACxE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,SAAS;IAC7D,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;CACnG,CAAC,CAAC;AACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
+
import { type ToolKit } from './kit.js';
|
|
3
|
+
/**
|
|
4
|
+
* Veri ve yapılandırma okuma araçları (public API ↔ MCP eşitliği): organizasyon ve app'ler, kullanıcı listesi, şirketler
|
|
5
|
+
* (ADR-0090), ilgi etiketleri ve kişi başına sıklık (ADR-0081), SQL sorgu ve SQL segment (ADR-0087), veri boru hattı
|
|
6
|
+
* (ADR-0088), ambar segmenti (ADR-0091), ambar dışa aktarımı, reverse ETL, dinamik içerik ve webhook'lar. Hepsi mevcut
|
|
7
|
+
* public API uçlarını çağırır; yetki her çağrıda sunucuda denetlenir. Kimlik bilgisi yöneten (API anahtarı, kimlik
|
|
8
|
+
* anahtarı), indirme bağlantısı taşıyan (dışa aktarım, Wallet kartı, kişi verisi dışa aktarımı) uçlar bilerek yoktur.
|
|
9
|
+
* `run_sql_query` yalnız SELECT çalıştırır (sunucu doğrular, salt okunur transaction); `preview_data_transform` kuru
|
|
10
|
+
* çalıştırmadır, kayıt yazmaz.
|
|
11
|
+
*/
|
|
12
|
+
export declare function registerDataTools(server: McpServer, kit: ToolKit): void;
|
|
13
|
+
//# sourceMappingURL=tools-data.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools-data.d.ts","sourceRoot":"","sources":["../src/tools-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAqF,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAE3H;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAsevE"}
|