@cesteral/tiktok-mcp 1.0.0

package/dist/services/tiktok/types.js

@@ -0,0 +1,31 @@
+export function isTikTokCampaign(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.campaign_id === "string" &&
+        typeof value.campaign_name === "string");
+}
+export function isTikTokAdGroup(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.adgroup_id === "string" &&
+        typeof value.adgroup_name === "string");
+}
+export function isTikTokAd(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.ad_id === "string" &&
+        typeof value.ad_name === "string");
+}
+export function isTikTokAdAccount(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.advertiser_id === "string" &&
+        typeof value.advertiser_name === "string");
+}
+export function isTikTokApiError(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.code === "number" &&
+        typeof value.message === "string");
+}
+//# sourceMappingURL=types.js.map

package/dist/services/tiktok/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/tiktok/types.ts"],"names":[],"mappings":"AAkOA,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,WAAW,KAAK,QAAQ;QAClE,OAAQ,KAAiC,CAAC,aAAa,KAAK,QAAQ,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,UAAU,KAAK,QAAQ;QACjE,OAAQ,KAAiC,CAAC,YAAY,KAAK,QAAQ,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,KAAK,KAAK,QAAQ;QAC5D,OAAQ,KAAiC,CAAC,OAAO,KAAK,QAAQ,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,aAAa,KAAK,QAAQ;QACpE,OAAQ,KAAiC,CAAC,eAAe,KAAK,QAAQ,CACvE,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAiC,CAAC,IAAI,KAAK,QAAQ;QAC3D,OAAQ,KAAiC,CAAC,OAAO,KAAK,QAAQ,CAC/D,CAAC;AACJ,CAAC"}

package/dist/types-global/mcp.d.ts

@@ -0,0 +1,2 @@
+export type { ToolDefinition, ResourceDefinition, SdkContext } from "@cesteral/shared";
+//# sourceMappingURL=mcp.d.ts.map

package/dist/types-global/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/types-global/mcp.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types-global/mcp.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/types-global/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/types-global/mcp.ts"],"names":[],"mappings":""}

package/dist/utils/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { McpError, ErrorHandler, type ErrorContext, JsonRpcErrorCode, mapErrorCodeToHttpStatus, } from "@cesteral/shared";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,YAAY,EACjB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/utils/errors/index.js

@@ -0,0 +1,2 @@
+export { McpError, ErrorHandler, JsonRpcErrorCode, mapErrorCodeToHttpStatus, } from "@cesteral/shared";
+//# sourceMappingURL=index.js.map

package/dist/utils/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,QAAQ,EACR,YAAY,EAEZ,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/utils/platform.d.ts

@@ -0,0 +1,3 @@
+export declare const withTikTokApiSpan: <T>(operation: string, entityType: string | undefined, fn: (span: import("@opentelemetry/api").Span) => Promise<T>) => Promise<T>;
+export declare const rateLimiter: import("@cesteral/shared").RateLimiter;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB,mIAAqC,CAAC;AACpE,eAAO,MAAM,WAAW,wCAA0E,CAAC"}

package/dist/utils/platform.js

@@ -0,0 +1,5 @@
+import { createPlatformSpanHelper, createPlatformRateLimiter } from "@cesteral/shared";
+import { mcpConfig } from "../config/index.js";
+export const withTikTokApiSpan = createPlatformSpanHelper("tiktok");
+export const rateLimiter = createPlatformRateLimiter("tiktok", mcpConfig.tiktokRateLimitPerMinute);
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,yBAAyB,CAAC,QAAQ,EAAE,SAAS,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/utils/security/rate-limiter.d.ts

@@ -0,0 +1,3 @@
+export { RateLimiter } from "@cesteral/shared";
+export declare const rateLimiter: import("@cesteral/shared").RateLimiter;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/security/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/utils/security/rate-limiter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,eAAO,MAAM,WAAW,wCAA0E,CAAC"}

package/dist/utils/security/rate-limiter.js

@@ -0,0 +1,5 @@
+export { RateLimiter } from "@cesteral/shared";
+import { createPlatformRateLimiter } from "@cesteral/shared";
+import { mcpConfig } from "../../config/index.js";
+export const rateLimiter = createPlatformRateLimiter("tiktok", mcpConfig.tiktokRateLimitPerMinute);
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/security/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../src/utils/security/rate-limiter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG,yBAAyB,CAAC,QAAQ,EAAE,SAAS,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/utils/telemetry/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./tracing.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC"}

package/dist/utils/telemetry/index.js

@@ -0,0 +1,2 @@
+export * from "./tracing.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/telemetry/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC"}

package/dist/utils/telemetry/tracing.d.ts

@@ -0,0 +1,3 @@
+export { initializeOpenTelemetry, shutdownOpenTelemetry, getOpenTelemetrySDK, isOpenTelemetryEnabled, otelLogMixin, getTracer, withSpan, withToolSpan, setSpanAttribute, recordSpanError, createPlatformSpanHelper, type Span, } from "@cesteral/shared";
+export declare const withTikTokApiSpan: <T>(operation: string, entityType: string | undefined, fn: (span: import("@opentelemetry/api").Span) => Promise<T>) => Promise<T>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/utils/telemetry/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/tracing.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,KAAK,IAAI,GACV,MAAM,kBAAkB,CAAC;AAI1B,eAAO,MAAM,iBAAiB,mIAAqC,CAAC"}

package/dist/utils/telemetry/tracing.js

@@ -0,0 +1,4 @@
+export { initializeOpenTelemetry, shutdownOpenTelemetry, getOpenTelemetrySDK, isOpenTelemetryEnabled, otelLogMixin, getTracer, withSpan, withToolSpan, setSpanAttribute, recordSpanError, createPlatformSpanHelper, } from "@cesteral/shared";
+import { createPlatformSpanHelper } from "@cesteral/shared";
+export const withTikTokApiSpan = createPlatformSpanHelper("tiktok");
+//# sourceMappingURL=tracing.js.map

package/dist/utils/telemetry/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/utils/telemetry/tracing.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@cesteral/tiktok-mcp",
+  "mcpName": "io.github.cesteral/tiktok-mcp",
+  "version": "1.0.0",
+  "description": "TikTok Ads MCP Server - Campaign entity management and reporting via TikTok Marketing API v1.3",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cesteral/mcp-open-advertising.git",
+    "directory": "packages/tiktok-mcp"
+  },
+  "homepage": "https://github.com/cesteral/mcp-open-advertising#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "advertising",
+    "tiktok-ads"
+  ],
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "tiktok-mcp": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "pino": "^10.1.0",
+    "zod": "3.25.76",
+    "@cesteral/shared": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "dev:http": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}