@cesteral/meta-mcp 1.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/LICENSE.md +201 -0
- package/README.md +337 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/meta-auth-adapter.d.ts +37 -0
- package/dist/auth/meta-auth-adapter.d.ts.map +1 -0
- package/dist/auth/meta-auth-adapter.js +109 -0
- package/dist/auth/meta-auth-adapter.js.map +1 -0
- package/dist/auth/meta-auth-strategy.d.ts +13 -0
- package/dist/auth/meta-auth-strategy.d.ts.map +1 -0
- package/dist/auth/meta-auth-strategy.js +47 -0
- package/dist/auth/meta-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +108 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +51 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/insights-catalog.json +95 -0
- package/dist/container/index.d.ts +5 -0
- package/dist/container/index.d.ts.map +1 -0
- package/dist/container/index.js +14 -0
- package/dist/container/index.js.map +1 -0
- package/dist/container/registrations/core.d.ts +3 -0
- package/dist/container/registrations/core.d.ts.map +1 -0
- package/dist/container/registrations/core.js +16 -0
- package/dist/container/registrations/core.js.map +1 -0
- package/dist/container/registrations/mcp.d.ts +2 -0
- package/dist/container/registrations/mcp.d.ts.map +1 -0
- package/dist/container/registrations/mcp.js +3 -0
- package/dist/container/registrations/mcp.js.map +1 -0
- package/dist/container/tokens.d.ts +6 -0
- package/dist/container/tokens.d.ts.map +1 -0
- package/dist/container/tokens.js +6 -0
- package/dist/container/tokens.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +40 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +244 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +111 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +160 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +234 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +159 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js +79 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +289 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +109 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +77 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +97 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +140 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +117 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +125 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/findings.resource.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/findings.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/findings.resource.js +33 -0
- package/dist/mcp-server/resources/definitions/findings.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +81 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js +113 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +98 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts +18 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.js +103 -0
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +133 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +221 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +178 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +143 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +108 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +180 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +125 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +140 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +148 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +107 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +104 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +93 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +102 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +183 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js +109 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +98 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +63 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts +91 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts +82 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js +72 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +90 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts +277 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js +175 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts +274 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js +188 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +141 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +157 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +73 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +29 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +87 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts +147 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +184 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +105 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts +128 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js +145 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +89 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +87 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +192 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +131 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +1714 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +146 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +88 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +94 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js +151 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +169 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +103 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +8 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js +70 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts +11 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.js +60 -0
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +14 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +138 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +53 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +80 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/meta/meta-graph-api-client.d.ts +19 -0
- package/dist/services/meta/meta-graph-api-client.d.ts.map +1 -0
- package/dist/services/meta/meta-graph-api-client.js +226 -0
- package/dist/services/meta/meta-graph-api-client.js.map +1 -0
- package/dist/services/meta/meta-insights-service.d.ts +76 -0
- package/dist/services/meta/meta-insights-service.d.ts.map +1 -0
- package/dist/services/meta/meta-insights-service.js +209 -0
- package/dist/services/meta/meta-insights-service.js.map +1 -0
- package/dist/services/meta/meta-service.d.ts +64 -0
- package/dist/services/meta/meta-service.d.ts.map +1 -0
- package/dist/services/meta/meta-service.js +177 -0
- package/dist/services/meta/meta-service.js.map +1 -0
- package/dist/services/meta/meta-targeting-service.d.ts +13 -0
- package/dist/services/meta/meta-targeting-service.d.ts.map +1 -0
- package/dist/services/meta/meta-targeting-service.js +38 -0
- package/dist/services/meta/meta-targeting-service.js.map +1 -0
- package/dist/services/meta/types.d.ts +227 -0
- package/dist/services/meta/types.d.ts.map +1 -0
- package/dist/services/meta/types.js +55 -0
- package/dist/services/meta/types.js.map +1 -0
- package/dist/services/session-services.d.ts +19 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +19 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts +9 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -0
- package/dist/testkit/fixtures/index.js +201 -0
- package/dist/testkit/fixtures/index.js.map +1 -0
- package/dist/testkit/index.d.ts +6 -0
- package/dist/testkit/index.d.ts.map +1 -0
- package/dist/testkit/index.js +26 -0
- package/dist/testkit/index.js.map +1 -0
- package/dist/testkit/types.d.ts +17 -0
- package/dist/testkit/types.d.ts.map +1 -0
- package/dist/testkit/types.js +2 -0
- package/dist/testkit/types.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/internal/request-context.d.ts +20 -0
- package/dist/utils/internal/request-context.d.ts.map +1 -0
- package/dist/utils/internal/request-context.js +19 -0
- package/dist/utils/internal/request-context.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +66 -0
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { extractHeader, fetchWithTimeout, fingerprintCredentials, JsonRpcErrorCode, McpError, OAuth2RefreshAdapterBase, } from "@cesteral/shared";
|
|
2
|
+
const DEFAULT_META_GRAPH_API_BASE_URL = "https://graph.facebook.com/v25.0";
|
|
3
|
+
async function fetchMetaUserId(token, baseUrl) {
|
|
4
|
+
const response = await fetchWithTimeout(`${baseUrl}/me?fields=id,name`, 10_000, undefined, {
|
|
5
|
+
headers: { Authorization: `Bearer ${token}` },
|
|
6
|
+
});
|
|
7
|
+
if (!response.ok) {
|
|
8
|
+
const errorBody = await response.text().catch(() => "");
|
|
9
|
+
throw new McpError(JsonRpcErrorCode.Unauthorized, `Meta token validation failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
|
|
10
|
+
}
|
|
11
|
+
const data = (await response.json());
|
|
12
|
+
return data.id;
|
|
13
|
+
}
|
|
14
|
+
export class MetaAccessTokenAdapter {
|
|
15
|
+
accessToken;
|
|
16
|
+
baseUrl;
|
|
17
|
+
validated = false;
|
|
18
|
+
_userId = "";
|
|
19
|
+
constructor(accessToken, baseUrl = DEFAULT_META_GRAPH_API_BASE_URL) {
|
|
20
|
+
this.accessToken = accessToken;
|
|
21
|
+
this.baseUrl = baseUrl;
|
|
22
|
+
}
|
|
23
|
+
get userId() {
|
|
24
|
+
return this._userId;
|
|
25
|
+
}
|
|
26
|
+
async getAccessToken() {
|
|
27
|
+
return this.accessToken;
|
|
28
|
+
}
|
|
29
|
+
async validate() {
|
|
30
|
+
if (this.validated)
|
|
31
|
+
return;
|
|
32
|
+
this._userId = await fetchMetaUserId(this.accessToken, this.baseUrl);
|
|
33
|
+
this.validated = true;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
export class MetaRefreshTokenAdapter extends OAuth2RefreshAdapterBase {
|
|
37
|
+
baseUrl;
|
|
38
|
+
_userId = "";
|
|
39
|
+
static EXPIRY_BUFFER_MS = 24 * 60 * 60 * 1000;
|
|
40
|
+
static INDEFINITE_EXPIRES_IN_SECONDS = 100 * 365 * 24 * 60 * 60;
|
|
41
|
+
constructor(initialToken, appCredentials, baseUrl = DEFAULT_META_GRAPH_API_BASE_URL) {
|
|
42
|
+
super({
|
|
43
|
+
platformName: "Meta",
|
|
44
|
+
credentials: {
|
|
45
|
+
appId: appCredentials.appId,
|
|
46
|
+
appSecret: appCredentials.appSecret,
|
|
47
|
+
refreshToken: initialToken,
|
|
48
|
+
},
|
|
49
|
+
expiryBufferMs: MetaRefreshTokenAdapter.EXPIRY_BUFFER_MS,
|
|
50
|
+
requestToken: async (tokenToExchange) => {
|
|
51
|
+
const params = new URLSearchParams({
|
|
52
|
+
grant_type: "fb_exchange_token",
|
|
53
|
+
client_id: appCredentials.appId,
|
|
54
|
+
client_secret: appCredentials.appSecret,
|
|
55
|
+
fb_exchange_token: tokenToExchange,
|
|
56
|
+
});
|
|
57
|
+
const response = await fetchWithTimeout(`${baseUrl}/oauth/access_token`, 10_000, undefined, {
|
|
58
|
+
method: "POST",
|
|
59
|
+
headers: { "Content-Type": "application/x-www-form-urlencoded" },
|
|
60
|
+
body: params.toString(),
|
|
61
|
+
});
|
|
62
|
+
if (!response.ok) {
|
|
63
|
+
const errorBody = await response.text().catch(() => "");
|
|
64
|
+
throw new McpError(JsonRpcErrorCode.InternalError, `Meta token exchange failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
|
|
65
|
+
}
|
|
66
|
+
const data = (await response.json());
|
|
67
|
+
if (!data.access_token) {
|
|
68
|
+
throw new McpError(JsonRpcErrorCode.InternalError, "Meta token exchange returned no access_token");
|
|
69
|
+
}
|
|
70
|
+
return {
|
|
71
|
+
access_token: data.access_token,
|
|
72
|
+
expires_in: data.expires_in ?? MetaRefreshTokenAdapter.INDEFINITE_EXPIRES_IN_SECONDS,
|
|
73
|
+
refresh_token: data.access_token,
|
|
74
|
+
};
|
|
75
|
+
},
|
|
76
|
+
});
|
|
77
|
+
this.baseUrl = baseUrl;
|
|
78
|
+
}
|
|
79
|
+
get userId() {
|
|
80
|
+
return this._userId;
|
|
81
|
+
}
|
|
82
|
+
async validate() {
|
|
83
|
+
const token = await this.getAccessToken();
|
|
84
|
+
this._userId = await fetchMetaUserId(token, this.baseUrl);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
export function parseMetaTokenFromHeaders(headers) {
|
|
88
|
+
const authHeader = extractHeader(headers, "authorization");
|
|
89
|
+
if (!authHeader) {
|
|
90
|
+
throw new Error("Missing required Authorization header");
|
|
91
|
+
}
|
|
92
|
+
const match = authHeader.match(/^Bearer\s+(.+)$/i);
|
|
93
|
+
if (!match || !match[1]) {
|
|
94
|
+
throw new Error("Authorization header must use Bearer scheme");
|
|
95
|
+
}
|
|
96
|
+
return match[1];
|
|
97
|
+
}
|
|
98
|
+
export function parseMetaAppCredentialsFromHeaders(headers) {
|
|
99
|
+
const appId = extractHeader(headers, "x-meta-app-id");
|
|
100
|
+
const appSecret = extractHeader(headers, "x-meta-app-secret");
|
|
101
|
+
if (!appId || !appSecret) {
|
|
102
|
+
return undefined;
|
|
103
|
+
}
|
|
104
|
+
return { appId, appSecret };
|
|
105
|
+
}
|
|
106
|
+
export function getMetaCredentialFingerprint(accessToken) {
|
|
107
|
+
return fingerprintCredentials(accessToken);
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=meta-auth-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/meta-auth-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Logger } from "pino";
|
|
2
|
+
import { BearerAuthStrategyBase, type BearerAdapterResult } from "@cesteral/shared";
|
|
3
|
+
export declare class MetaBearerAuthStrategy extends BearerAuthStrategyBase {
|
|
4
|
+
private readonly baseUrl;
|
|
5
|
+
protected readonly authType = "meta-bearer";
|
|
6
|
+
protected readonly platformName = "Meta";
|
|
7
|
+
constructor(baseUrl: string, logger?: Logger);
|
|
8
|
+
protected resolveRefreshBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult | null>;
|
|
9
|
+
protected resolveAccessBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult>;
|
|
10
|
+
protected getRefreshFingerprint(headers: Record<string, string | string[] | undefined>): string | undefined;
|
|
11
|
+
protected getTokenFingerprint(headers: Record<string, string | string[] | undefined>): string;
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=meta-auth-strategy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta-auth-strategy.d.ts","sourceRoot":"","sources":["../../src/auth/meta-auth-strategy.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AASpF,qBAAa,sBAAuB,SAAQ,sBAAsB;IAK9D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,SAAS,CAAC,QAAQ,CAAC,QAAQ,iBAAiB;IAC5C,SAAS,CAAC,QAAQ,CAAC,YAAY,UAAU;gBAGtB,OAAO,EAAE,MAAM,EAChC,MAAM,CAAC,EAAE,MAAM;cAKD,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;cAiBtB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,CAAC;IAa/B,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,GAAG,SAAS;IAMrB,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM;CAI9F"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { BearerAuthStrategyBase } from "@cesteral/shared";
|
|
2
|
+
import { MetaAccessTokenAdapter, MetaRefreshTokenAdapter, parseMetaTokenFromHeaders, parseMetaAppCredentialsFromHeaders, getMetaCredentialFingerprint, } from "./meta-auth-adapter.js";
|
|
3
|
+
export class MetaBearerAuthStrategy extends BearerAuthStrategyBase {
|
|
4
|
+
baseUrl;
|
|
5
|
+
authType = "meta-bearer";
|
|
6
|
+
platformName = "Meta";
|
|
7
|
+
constructor(baseUrl, logger) {
|
|
8
|
+
super(logger);
|
|
9
|
+
this.baseUrl = baseUrl;
|
|
10
|
+
}
|
|
11
|
+
async resolveRefreshBranch(headers) {
|
|
12
|
+
const appCreds = parseMetaAppCredentialsFromHeaders(headers);
|
|
13
|
+
if (!appCreds)
|
|
14
|
+
return null;
|
|
15
|
+
const token = parseMetaTokenFromHeaders(headers);
|
|
16
|
+
const adapter = new MetaRefreshTokenAdapter(token, appCreds, this.baseUrl);
|
|
17
|
+
await adapter.validate();
|
|
18
|
+
return {
|
|
19
|
+
adapter,
|
|
20
|
+
fingerprint: getMetaCredentialFingerprint(appCreds.appId),
|
|
21
|
+
userId: adapter.userId,
|
|
22
|
+
authFlow: "token-exchange",
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
async resolveAccessBranch(headers) {
|
|
26
|
+
const token = parseMetaTokenFromHeaders(headers);
|
|
27
|
+
const adapter = new MetaAccessTokenAdapter(token, this.baseUrl);
|
|
28
|
+
await adapter.validate();
|
|
29
|
+
return {
|
|
30
|
+
adapter,
|
|
31
|
+
fingerprint: getMetaCredentialFingerprint(token),
|
|
32
|
+
userId: adapter.userId,
|
|
33
|
+
authFlow: "static-token",
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
getRefreshFingerprint(headers) {
|
|
37
|
+
const appCreds = parseMetaAppCredentialsFromHeaders(headers);
|
|
38
|
+
if (!appCreds)
|
|
39
|
+
return undefined;
|
|
40
|
+
return getMetaCredentialFingerprint(appCreds.appId);
|
|
41
|
+
}
|
|
42
|
+
getTokenFingerprint(headers) {
|
|
43
|
+
const token = parseMetaTokenFromHeaders(headers);
|
|
44
|
+
return getMetaCredentialFingerprint(token);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=meta-auth-strategy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta-auth-strategy.js","sourceRoot":"","sources":["../../src/auth/meta-auth-strategy.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,sBAAsB,EAA4B,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,kCAAkC,EAClC,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,sBAAuB,SAAQ,sBAAsB;IAK7C;IAJA,QAAQ,GAAG,aAAa,CAAC;IACzB,YAAY,GAAG,MAAM,CAAC;IAEzC,YACmB,OAAe,EAChC,MAAe;QAEf,KAAK,CAAC,MAAM,CAAC,CAAC;QAHG,YAAO,GAAP,OAAO,CAAQ;IAIlC,CAAC;IAES,KAAK,CAAC,oBAAoB,CAClC,OAAsD;QAGtD,MAAM,QAAQ,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3E,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YACP,WAAW,EAAE,4BAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,gBAAgB;SAC3B,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,mBAAmB,CACjC,OAAsD;QAEtD,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YACP,WAAW,EAAE,4BAA4B,CAAC,KAAK,CAAC;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,cAAc;SACzB,CAAC;IACJ,CAAC;IAES,qBAAqB,CAC7B,OAAsD;QAEtD,MAAM,QAAQ,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,OAAO,4BAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAES,mBAAmB,CAAC,OAAsD;QAClF,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
declare const ConfigSchema: z.ZodObject<{
|
|
3
|
+
host: z.ZodDefault<z.ZodString>;
|
|
4
|
+
nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
|
|
5
|
+
mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
6
|
+
mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
|
|
7
|
+
mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
|
|
8
|
+
logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
|
|
9
|
+
mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
|
|
10
|
+
otelEnabled: z.ZodDefault<z.ZodBoolean>;
|
|
11
|
+
otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
|
|
12
|
+
otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
|
|
13
|
+
gcsBucketName: z.ZodOptional<z.ZodString>;
|
|
14
|
+
} & {
|
|
15
|
+
serviceName: z.ZodDefault<z.ZodString>;
|
|
16
|
+
port: z.ZodDefault<z.ZodNumber>;
|
|
17
|
+
otelServiceName: z.ZodDefault<z.ZodString>;
|
|
18
|
+
mcpAuthMode: z.ZodDefault<z.ZodEnum<["meta-bearer", "jwt", "none"]>>;
|
|
19
|
+
metaApiBaseUrl: z.ZodDefault<z.ZodString>;
|
|
20
|
+
metaApiVersion: z.ZodDefault<z.ZodString>;
|
|
21
|
+
metaRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
|
|
22
|
+
metaAccessToken: z.ZodOptional<z.ZodString>;
|
|
23
|
+
metaVideoUploadPollIntervalMs: z.ZodDefault<z.ZodNumber>;
|
|
24
|
+
metaVideoUploadMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
|
|
25
|
+
metaVideoUploadMaxBufferedBytes: z.ZodDefault<z.ZodNumber>;
|
|
26
|
+
metaAppId: z.ZodOptional<z.ZodString>;
|
|
27
|
+
metaAppSecret: z.ZodOptional<z.ZodString>;
|
|
28
|
+
}, "strip", z.ZodTypeAny, {
|
|
29
|
+
serviceName: string;
|
|
30
|
+
port: number;
|
|
31
|
+
otelServiceName: string;
|
|
32
|
+
mcpAuthMode: "meta-bearer" | "jwt" | "none";
|
|
33
|
+
metaApiBaseUrl: string;
|
|
34
|
+
metaApiVersion: string;
|
|
35
|
+
metaRateLimitPerMinute: number;
|
|
36
|
+
metaVideoUploadPollIntervalMs: number;
|
|
37
|
+
metaVideoUploadMaxPollAttempts: number;
|
|
38
|
+
metaVideoUploadMaxBufferedBytes: number;
|
|
39
|
+
host: string;
|
|
40
|
+
nodeEnv: "development" | "production" | "test";
|
|
41
|
+
mcpStatefulSessionTimeoutMs: number;
|
|
42
|
+
logLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
43
|
+
mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
44
|
+
otelEnabled: boolean;
|
|
45
|
+
metaAccessToken?: string | undefined;
|
|
46
|
+
metaAppId?: string | undefined;
|
|
47
|
+
metaAppSecret?: string | undefined;
|
|
48
|
+
mcpAuthSecretKey?: string | undefined;
|
|
49
|
+
mcpAllowedOrigins?: string | undefined;
|
|
50
|
+
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
51
|
+
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
52
|
+
gcsBucketName?: string | undefined;
|
|
53
|
+
}, {
|
|
54
|
+
serviceName?: string | undefined;
|
|
55
|
+
port?: number | undefined;
|
|
56
|
+
otelServiceName?: string | undefined;
|
|
57
|
+
mcpAuthMode?: "meta-bearer" | "jwt" | "none" | undefined;
|
|
58
|
+
metaApiBaseUrl?: string | undefined;
|
|
59
|
+
metaApiVersion?: string | undefined;
|
|
60
|
+
metaRateLimitPerMinute?: number | undefined;
|
|
61
|
+
metaAccessToken?: string | undefined;
|
|
62
|
+
metaVideoUploadPollIntervalMs?: number | undefined;
|
|
63
|
+
metaVideoUploadMaxPollAttempts?: number | undefined;
|
|
64
|
+
metaVideoUploadMaxBufferedBytes?: number | undefined;
|
|
65
|
+
metaAppId?: string | undefined;
|
|
66
|
+
metaAppSecret?: string | undefined;
|
|
67
|
+
host?: string | undefined;
|
|
68
|
+
nodeEnv?: "development" | "production" | "test" | undefined;
|
|
69
|
+
mcpStatefulSessionTimeoutMs?: number | undefined;
|
|
70
|
+
mcpAuthSecretKey?: string | undefined;
|
|
71
|
+
mcpAllowedOrigins?: string | undefined;
|
|
72
|
+
logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
|
|
73
|
+
mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
|
|
74
|
+
otelEnabled?: boolean | undefined;
|
|
75
|
+
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
76
|
+
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
77
|
+
gcsBucketName?: string | undefined;
|
|
78
|
+
}>;
|
|
79
|
+
export type AppConfig = z.infer<typeof ConfigSchema>;
|
|
80
|
+
export declare function parseConfig(): AppConfig;
|
|
81
|
+
export declare const mcpConfig: {
|
|
82
|
+
serviceName: string;
|
|
83
|
+
port: number;
|
|
84
|
+
otelServiceName: string;
|
|
85
|
+
mcpAuthMode: "meta-bearer" | "jwt" | "none";
|
|
86
|
+
metaApiBaseUrl: string;
|
|
87
|
+
metaApiVersion: string;
|
|
88
|
+
metaRateLimitPerMinute: number;
|
|
89
|
+
metaVideoUploadPollIntervalMs: number;
|
|
90
|
+
metaVideoUploadMaxPollAttempts: number;
|
|
91
|
+
metaVideoUploadMaxBufferedBytes: number;
|
|
92
|
+
host: string;
|
|
93
|
+
nodeEnv: "development" | "production" | "test";
|
|
94
|
+
mcpStatefulSessionTimeoutMs: number;
|
|
95
|
+
logLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
96
|
+
mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
97
|
+
otelEnabled: boolean;
|
|
98
|
+
metaAccessToken?: string | undefined;
|
|
99
|
+
metaAppId?: string | undefined;
|
|
100
|
+
metaAppSecret?: string | undefined;
|
|
101
|
+
mcpAuthSecretKey?: string | undefined;
|
|
102
|
+
mcpAllowedOrigins?: string | undefined;
|
|
103
|
+
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
104
|
+
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
105
|
+
gcsBucketName?: string | undefined;
|
|
106
|
+
};
|
|
107
|
+
export {};
|
|
108
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgChB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CAsCvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
|
|
3
|
+
loadDotEnv();
|
|
4
|
+
const ConfigSchema = BaseConfigSchema.extend({
|
|
5
|
+
serviceName: z.string().default("meta-mcp"),
|
|
6
|
+
port: z.number().int().min(1).max(65535).default(3005),
|
|
7
|
+
otelServiceName: z.string().default("meta-mcp"),
|
|
8
|
+
mcpAuthMode: z.enum(["meta-bearer", "jwt", "none"]).default("meta-bearer"),
|
|
9
|
+
metaApiBaseUrl: z.string().url().default("https://graph.facebook.com/v25.0"),
|
|
10
|
+
metaApiVersion: z.string().default("v25.0"),
|
|
11
|
+
metaRateLimitPerMinute: z.number().default(20),
|
|
12
|
+
metaAccessToken: z.string().optional(),
|
|
13
|
+
metaVideoUploadPollIntervalMs: z.number().default(15_000),
|
|
14
|
+
metaVideoUploadMaxPollAttempts: z.number().default(20),
|
|
15
|
+
metaVideoUploadMaxBufferedBytes: z
|
|
16
|
+
.number()
|
|
17
|
+
.int()
|
|
18
|
+
.positive()
|
|
19
|
+
.default(256 * 1024 * 1024),
|
|
20
|
+
metaAppId: z.string().optional(),
|
|
21
|
+
metaAppSecret: z.string().optional(),
|
|
22
|
+
});
|
|
23
|
+
export function parseConfig() {
|
|
24
|
+
const defaultHost = getDefaultHost();
|
|
25
|
+
const rawConfig = {
|
|
26
|
+
...getBaseEnvConfig(defaultHost),
|
|
27
|
+
serviceName: process.env.SERVICE_NAME,
|
|
28
|
+
...(process.env.META_MCP_PORT ? { port: Number(process.env.META_MCP_PORT) } : {}),
|
|
29
|
+
host: process.env.META_MCP_HOST || defaultHost,
|
|
30
|
+
metaApiBaseUrl: process.env.META_API_BASE_URL,
|
|
31
|
+
metaApiVersion: process.env.META_API_VERSION,
|
|
32
|
+
metaRateLimitPerMinute: process.env.META_RATE_LIMIT_PER_MINUTE
|
|
33
|
+
? Number(process.env.META_RATE_LIMIT_PER_MINUTE)
|
|
34
|
+
: undefined,
|
|
35
|
+
metaVideoUploadPollIntervalMs: process.env.META_VIDEO_UPLOAD_POLL_INTERVAL_MS
|
|
36
|
+
? Number(process.env.META_VIDEO_UPLOAD_POLL_INTERVAL_MS)
|
|
37
|
+
: undefined,
|
|
38
|
+
metaVideoUploadMaxPollAttempts: process.env.META_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS
|
|
39
|
+
? Number(process.env.META_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS)
|
|
40
|
+
: undefined,
|
|
41
|
+
metaVideoUploadMaxBufferedBytes: process.env.META_VIDEO_UPLOAD_MAX_BUFFERED_BYTES
|
|
42
|
+
? Number(process.env.META_VIDEO_UPLOAD_MAX_BUFFERED_BYTES)
|
|
43
|
+
: undefined,
|
|
44
|
+
metaAccessToken: process.env.META_ACCESS_TOKEN,
|
|
45
|
+
metaAppId: process.env.META_APP_ID,
|
|
46
|
+
metaAppSecret: process.env.META_APP_SECRET,
|
|
47
|
+
};
|
|
48
|
+
return parseConfigWithSchema(ConfigSchema, rawConfig);
|
|
49
|
+
}
|
|
50
|
+
export const mcpConfig = parseConfig();
|
|
51
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
{
|
|
2
|
+
"description": "Static catalog of Meta Marketing API v24.0+ Insights fields, breakdowns, and action breakdowns. Seeded from https://developers.facebook.com/docs/marketing-api/insights/parameters. Keep in sync as the API evolves.",
|
|
3
|
+
"levels": ["account", "campaign", "adset", "ad"],
|
|
4
|
+
"metrics": {
|
|
5
|
+
"delivery": ["impressions", "reach", "frequency", "spend", "cpm", "cpp"],
|
|
6
|
+
"engagement": [
|
|
7
|
+
"clicks",
|
|
8
|
+
"unique_clicks",
|
|
9
|
+
"cpc",
|
|
10
|
+
"unique_cpc",
|
|
11
|
+
"ctr",
|
|
12
|
+
"unique_ctr",
|
|
13
|
+
"inline_link_clicks",
|
|
14
|
+
"inline_link_click_ctr",
|
|
15
|
+
"cost_per_inline_link_click",
|
|
16
|
+
"inline_post_engagement",
|
|
17
|
+
"cost_per_inline_post_engagement"
|
|
18
|
+
],
|
|
19
|
+
"video": [
|
|
20
|
+
"video_play_actions",
|
|
21
|
+
"video_thruplay_watched_actions",
|
|
22
|
+
"video_p25_watched_actions",
|
|
23
|
+
"video_p50_watched_actions",
|
|
24
|
+
"video_p75_watched_actions",
|
|
25
|
+
"video_p95_watched_actions",
|
|
26
|
+
"video_p100_watched_actions",
|
|
27
|
+
"video_avg_time_watched_actions",
|
|
28
|
+
"cost_per_thruplay"
|
|
29
|
+
],
|
|
30
|
+
"conversions": [
|
|
31
|
+
"actions",
|
|
32
|
+
"action_values",
|
|
33
|
+
"unique_actions",
|
|
34
|
+
"cost_per_action_type",
|
|
35
|
+
"cost_per_unique_action_type",
|
|
36
|
+
"conversions",
|
|
37
|
+
"conversion_values",
|
|
38
|
+
"cost_per_conversion",
|
|
39
|
+
"purchase_roas",
|
|
40
|
+
"website_purchase_roas"
|
|
41
|
+
],
|
|
42
|
+
"attribution": ["attribution_setting", "mobile_app_purchase_roas"],
|
|
43
|
+
"quality": ["quality_ranking", "engagement_rate_ranking", "conversion_rate_ranking"],
|
|
44
|
+
"other": [
|
|
45
|
+
"date_start",
|
|
46
|
+
"date_stop",
|
|
47
|
+
"account_id",
|
|
48
|
+
"account_name",
|
|
49
|
+
"account_currency",
|
|
50
|
+
"campaign_id",
|
|
51
|
+
"campaign_name",
|
|
52
|
+
"adset_id",
|
|
53
|
+
"adset_name",
|
|
54
|
+
"ad_id",
|
|
55
|
+
"ad_name",
|
|
56
|
+
"objective",
|
|
57
|
+
"optimization_goal",
|
|
58
|
+
"buying_type"
|
|
59
|
+
]
|
|
60
|
+
},
|
|
61
|
+
"breakdowns": [
|
|
62
|
+
"age",
|
|
63
|
+
"gender",
|
|
64
|
+
"country",
|
|
65
|
+
"region",
|
|
66
|
+
"dma",
|
|
67
|
+
"impression_device",
|
|
68
|
+
"publisher_platform",
|
|
69
|
+
"platform_position",
|
|
70
|
+
"device_platform",
|
|
71
|
+
"product_id",
|
|
72
|
+
"hourly_stats_aggregated_by_advertiser_time_zone",
|
|
73
|
+
"hourly_stats_aggregated_by_audience_time_zone",
|
|
74
|
+
"frequency_value"
|
|
75
|
+
],
|
|
76
|
+
"actionBreakdowns": [
|
|
77
|
+
"action_type",
|
|
78
|
+
"action_target_id",
|
|
79
|
+
"action_destination",
|
|
80
|
+
"action_device",
|
|
81
|
+
"action_video_sound",
|
|
82
|
+
"action_video_type",
|
|
83
|
+
"action_carousel_card_id",
|
|
84
|
+
"action_carousel_card_name",
|
|
85
|
+
"action_converted_product_id",
|
|
86
|
+
"action_reaction",
|
|
87
|
+
"standard_event_content_type"
|
|
88
|
+
],
|
|
89
|
+
"notes": [
|
|
90
|
+
"`breakdowns` and `action_breakdowns` may be combined; some pairs are invalid (e.g. impression_device + publisher_platform cross-breakdowns) — the API will reject invalid combinations with error code 100.",
|
|
91
|
+
"`attribution_setting` controls the attribution window; default is the ad account's default setting.",
|
|
92
|
+
"`quality_ranking`, `engagement_rate_ranking`, `conversion_rate_ranking` require ads with sufficient delivery (typically 500+ impressions over the last 7 days).",
|
|
93
|
+
"This catalog is a snapshot. For the authoritative current list, see the Meta Marketing API docs or call Meta's own field-introspection endpoints."
|
|
94
|
+
]
|
|
95
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAStD;AAED,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import "reflect-metadata";
|
|
2
|
+
import { registerCoreServices } from "./registrations/core.js";
|
|
3
|
+
import { registerMcpServices } from "./registrations/mcp.js";
|
|
4
|
+
let isContainerComposed = false;
|
|
5
|
+
export function composeContainer(logger) {
|
|
6
|
+
if (isContainerComposed) {
|
|
7
|
+
return;
|
|
8
|
+
}
|
|
9
|
+
registerCoreServices(logger);
|
|
10
|
+
registerMcpServices();
|
|
11
|
+
isContainerComposed = true;
|
|
12
|
+
}
|
|
13
|
+
export * as Tokens from "./tokens.js";
|
|
14
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,CAAC;IAEtB,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC;AAED,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/container/registrations/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAW1D"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { container } from "tsyringe";
|
|
2
|
+
import { createLogger } from "@cesteral/shared";
|
|
3
|
+
import { appConfig } from "../../config/index.js";
|
|
4
|
+
import * as Tokens from "../tokens.js";
|
|
5
|
+
import { rateLimiter } from "../../utils/security/rate-limiter.js";
|
|
6
|
+
import { requestContextService } from "@cesteral/shared";
|
|
7
|
+
export function registerCoreServices(logger) {
|
|
8
|
+
container.register(Tokens.AppConfig, { useValue: appConfig });
|
|
9
|
+
const loggerInstance = logger || createLogger("meta-mcp");
|
|
10
|
+
container.register(Tokens.Logger, { useValue: loggerInstance });
|
|
11
|
+
container.register(Tokens.RequestContextService, { useValue: requestContextService });
|
|
12
|
+
container.register(Tokens.RateLimiterService, {
|
|
13
|
+
useValue: rateLimiter,
|
|
14
|
+
});
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=core.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/container/registrations/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9D,MAAM,cAAc,GAAG,MAAM,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAEtF,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC5C,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAC;AACL,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/container/registrations/mcp.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/container/registrations/mcp.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB;AAInC,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export declare const AppConfig: unique symbol;
|
|
2
|
+
export declare const Logger: unique symbol;
|
|
3
|
+
export declare const RateLimiterService: unique symbol;
|
|
4
|
+
export declare const RequestContextService: unique symbol;
|
|
5
|
+
export declare const ResourceRegistry: unique symbol;
|
|
6
|
+
//# sourceMappingURL=tokens.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/container/tokens.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,eAAO,MAAM,MAAM,eAAmB,CAAC;AAGvC,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAGrE,eAAO,MAAM,gBAAgB,eAA6B,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export const AppConfig = Symbol("AppConfig");
|
|
2
|
+
export const Logger = Symbol("Logger");
|
|
3
|
+
export const RateLimiterService = Symbol("RateLimiterService");
|
|
4
|
+
export const RequestContextService = Symbol("RequestContextService");
|
|
5
|
+
export const ResourceRegistry = Symbol("ResourceRegistry");
|
|
6
|
+
//# sourceMappingURL=tokens.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/container/tokens.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAGvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAGrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { mcpConfig } from "./config/index.js";
|
|
3
|
+
import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
|
|
4
|
+
import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
|
|
5
|
+
import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
|
|
6
|
+
import { MetaAccessTokenAdapter } from "./auth/meta-auth-adapter.js";
|
|
7
|
+
import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
|
|
8
|
+
import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
|
|
9
|
+
import { rateLimiter } from "./utils/platform.js";
|
|
10
|
+
const transportMode = detectTransportMode();
|
|
11
|
+
const logger = createServerLogger("meta-mcp", transportMode, otelLogMixin());
|
|
12
|
+
async function setupStdioCredentials(sessionId) {
|
|
13
|
+
const accessToken = mcpConfig.metaAccessToken;
|
|
14
|
+
if (!accessToken) {
|
|
15
|
+
logger.warn("No Meta credentials found in env vars. " + "Set META_ACCESS_TOKEN for stdio mode.");
|
|
16
|
+
return false;
|
|
17
|
+
}
|
|
18
|
+
const authAdapter = new MetaAccessTokenAdapter(accessToken, mcpConfig.metaApiBaseUrl);
|
|
19
|
+
await authAdapter.validate();
|
|
20
|
+
const services = createSessionServices(authAdapter, { baseUrl: mcpConfig.metaApiBaseUrl }, logger, rateLimiter);
|
|
21
|
+
sessionServiceStore.set(sessionId, services);
|
|
22
|
+
logger.info("Stdio session services created successfully");
|
|
23
|
+
return true;
|
|
24
|
+
}
|
|
25
|
+
bootstrapMcpServer({
|
|
26
|
+
serviceName: "meta-mcp",
|
|
27
|
+
config: mcpConfig,
|
|
28
|
+
logger,
|
|
29
|
+
transportMode,
|
|
30
|
+
initOtel: initializeOpenTelemetry,
|
|
31
|
+
setupStdioSession: setupStdioCredentials,
|
|
32
|
+
createMcpServer,
|
|
33
|
+
runStdio: runStdioServer,
|
|
34
|
+
startHttp: startHttpServer,
|
|
35
|
+
onShutdown: () => rateLimiter.destroy(),
|
|
36
|
+
}).catch((err) => {
|
|
37
|
+
logger.fatal({ err }, "Failed to start meta-mcp");
|
|
38
|
+
process.exit(1);
|
|
39
|
+
});
|
|
40
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAM7E,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,eAAe,CAAC;IAE9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CACT,yCAAyC,GAAG,uCAAuC,CACpF,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAGtF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX,EAAE,OAAO,EAAE,SAAS,CAAC,cAAc,EAAE,EACrC,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const bulkOperationsWorkflowPrompt: Prompt;
|
|
3
|
+
export declare function getBulkOperationsWorkflowMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAmOtF"}
|