@jaypie/mcp 0.2.12 → 0.3.0

package/README.md

@@ -0,0 +1,62 @@
+# Jaypie MCP
+
+MCP (Model Context Protocol) server for Jaypie development. Provides tools for AI agents to access Jaypie documentation, development guides, Datadog observability data, and AWS CLI operations.
+
+## Usage
+
+```bash
+npx jaypie-mcp          # Run MCP server via stdio
+npx jaypie-mcp --verbose # Run with debug logging
+```
+
+## Environment Variables
+
+### AWS CLI Integration
+| Variable | Description |
+|----------|-------------|
+| `AWS_PROFILE` | Default profile if not specified per-call |
+| `AWS_REGION` or `AWS_DEFAULT_REGION` | Default region if not specified |
+
+AWS tools use the host's existing credential chain:
+- `~/.aws/credentials` and `~/.aws/config` files
+- Environment variables (`AWS_ACCESS_KEY_ID`, etc.)
+- SSO sessions established via `aws sso login`
+
+### Datadog Integration
+| Variable | Description |
+|----------|-------------|
+| `DATADOG_API_KEY` or `DD_API_KEY` | Datadog API key |
+| `DATADOG_APP_KEY` or `DD_APP_KEY` | Datadog Application key |
+| `DD_ENV` | Default environment filter |
+| `DD_SERVICE` | Default service filter |
+| `DD_SOURCE` | Default log source (defaults to "lambda") |
+| `DD_QUERY` | Default query terms appended to searches |
+
+## MCP Tools
+
+### Documentation Tools
+- `list_prompts` - Lists Jaypie development prompts and guides
+- `read_prompt` - Returns content of a specific prompt file
+- `version` - Returns package version string
+
+### AWS CLI Tools (16 tools)
+- Step Functions: `aws_stepfunctions_list_executions`, `aws_stepfunctions_stop_execution`
+- Lambda: `aws_lambda_list_functions`, `aws_lambda_get_function`
+- CloudWatch Logs: `aws_logs_filter_log_events`
+- S3: `aws_s3_list_objects`
+- CloudFormation: `aws_cloudformation_describe_stack`
+- DynamoDB: `aws_dynamodb_describe_table`, `aws_dynamodb_scan`, `aws_dynamodb_query`, `aws_dynamodb_get_item`
+- SQS: `aws_sqs_list_queues`, `aws_sqs_get_queue_attributes`, `aws_sqs_receive_message`, `aws_sqs_purge_queue`
+- Profiles: `aws_list_profiles`
+
+### Datadog Tools (6 tools)
+- `datadog_logs`, `datadog_log_analytics`, `datadog_monitors`, `datadog_synthetics`, `datadog_metrics`, `datadog_rum`
+
+### LLM Tools (2 tools)
+- `llm_debug_call`, `llm_list_providers`
+
+See [CLAUDE.md](./CLAUDE.md) for detailed documentation.
+
+## License
+
+[MIT License](./LICENSE.txt). Published by Finlayson Studio

package/dist/aws.d.ts

@@ -0,0 +1,197 @@
+interface Logger {
+    info: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+}
+export interface AwsCommandOptions {
+    profile?: string;
+    region?: string;
+}
+export interface AwsCommandResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+export interface StepFunctionExecution {
+    executionArn: string;
+    stateMachineArn: string;
+    name: string;
+    status: string;
+    startDate: string;
+    stopDate?: string;
+}
+export interface StepFunctionsListExecutionsOptions extends AwsCommandOptions {
+    stateMachineArn: string;
+    statusFilter?: "RUNNING" | "SUCCEEDED" | "FAILED" | "TIMED_OUT" | "ABORTED" | "PENDING_REDRIVE";
+    maxResults?: number;
+}
+export interface StepFunctionsStopExecutionOptions extends AwsCommandOptions {
+    executionArn: string;
+    cause?: string;
+}
+export interface LambdaFunction {
+    FunctionName: string;
+    FunctionArn: string;
+    Runtime?: string;
+    Handler?: string;
+    CodeSize: number;
+    Description?: string;
+    Timeout?: number;
+    MemorySize?: number;
+    LastModified: string;
+    Version?: string;
+}
+export interface LambdaListFunctionsOptions extends AwsCommandOptions {
+    functionNamePrefix?: string;
+    maxResults?: number;
+}
+export interface LambdaGetFunctionOptions extends AwsCommandOptions {
+    functionName: string;
+}
+export interface LogEvent {
+    timestamp: number;
+    message: string;
+    ingestionTime?: number;
+    logStreamName?: string;
+}
+export interface CloudWatchLogsFilterOptions extends AwsCommandOptions {
+    logGroupName: string;
+    filterPattern?: string;
+    startTime?: string;
+    endTime?: string;
+    limit?: number;
+}
+export interface S3Object {
+    Key: string;
+    LastModified: string;
+    ETag: string;
+    Size: number;
+    StorageClass: string;
+}
+export interface S3ListObjectsOptions extends AwsCommandOptions {
+    bucket: string;
+    prefix?: string;
+    maxResults?: number;
+}
+export interface CloudFormationStack {
+    StackName: string;
+    StackId: string;
+    StackStatus: string;
+    StackStatusReason?: string;
+    CreationTime: string;
+    LastUpdatedTime?: string;
+    Description?: string;
+    Outputs?: Array<{
+        OutputKey: string;
+        OutputValue: string;
+        Description?: string;
+    }>;
+    Parameters?: Array<{
+        ParameterKey: string;
+        ParameterValue: string;
+    }>;
+}
+export interface CloudFormationDescribeStackOptions extends AwsCommandOptions {
+    stackName: string;
+}
+export interface DynamoDBDescribeTableOptions extends AwsCommandOptions {
+    tableName: string;
+}
+export interface DynamoDBScanOptions extends AwsCommandOptions {
+    tableName: string;
+    filterExpression?: string;
+    expressionAttributeValues?: string;
+    limit?: number;
+}
+export interface DynamoDBQueryOptions extends AwsCommandOptions {
+    tableName: string;
+    keyConditionExpression: string;
+    expressionAttributeValues: string;
+    indexName?: string;
+    filterExpression?: string;
+    limit?: number;
+    scanIndexForward?: boolean;
+}
+export interface DynamoDBGetItemOptions extends AwsCommandOptions {
+    tableName: string;
+    key: string;
+}
+export interface SQSQueue {
+    QueueUrl: string;
+}
+export interface SQSListQueuesOptions extends AwsCommandOptions {
+    queueNamePrefix?: string;
+}
+export interface SQSGetQueueAttributesOptions extends AwsCommandOptions {
+    queueUrl: string;
+}
+export interface SQSReceiveMessageOptions extends AwsCommandOptions {
+    queueUrl: string;
+    maxNumberOfMessages?: number;
+    visibilityTimeout?: number;
+}
+export interface SQSPurgeQueueOptions extends AwsCommandOptions {
+    queueUrl: string;
+}
+export interface AwsProfile {
+    name: string;
+    source: "config" | "credentials";
+    region?: string;
+    sso_start_url?: string;
+}
+/**
+ * Execute an AWS CLI command and return parsed JSON output
+ */
+export declare function executeAwsCommand<T>(service: string, command: string, args: string[], options?: AwsCommandOptions, logger?: Logger): Promise<AwsCommandResult<T>>;
+/**
+ * List available AWS profiles from ~/.aws/config and ~/.aws/credentials
+ */
+export declare function listAwsProfiles(logger?: Logger): Promise<AwsCommandResult<AwsProfile[]>>;
+export declare function listStepFunctionExecutions(options: StepFunctionsListExecutionsOptions, logger?: Logger): Promise<AwsCommandResult<{
+    executions: StepFunctionExecution[];
+}>>;
+export declare function stopStepFunctionExecution(options: StepFunctionsStopExecutionOptions, logger?: Logger): Promise<AwsCommandResult<{
+    stopDate: string;
+}>>;
+export declare function listLambdaFunctions(options?: LambdaListFunctionsOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Functions: LambdaFunction[];
+}>>;
+export declare function getLambdaFunction(options: LambdaGetFunctionOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Configuration: LambdaFunction;
+}>>;
+export declare function filterLogEvents(options: CloudWatchLogsFilterOptions, logger?: Logger): Promise<AwsCommandResult<{
+    events: LogEvent[];
+}>>;
+export declare function listS3Objects(options: S3ListObjectsOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Contents: S3Object[];
+}>>;
+export declare function describeStack(options: CloudFormationDescribeStackOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Stacks: CloudFormationStack[];
+}>>;
+export declare function describeDynamoDBTable(options: DynamoDBDescribeTableOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Table: Record<string, unknown>;
+}>>;
+export declare function scanDynamoDB(options: DynamoDBScanOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Items: Record<string, unknown>[];
+}>>;
+export declare function queryDynamoDB(options: DynamoDBQueryOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Items: Record<string, unknown>[];
+}>>;
+export declare function getDynamoDBItem(options: DynamoDBGetItemOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Item: Record<string, unknown>;
+}>>;
+export declare function listSQSQueues(options?: SQSListQueuesOptions, logger?: Logger): Promise<AwsCommandResult<{
+    QueueUrls: string[];
+}>>;
+export declare function getSQSQueueAttributes(options: SQSGetQueueAttributesOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Attributes: Record<string, string>;
+}>>;
+export declare function receiveSQSMessage(options: SQSReceiveMessageOptions, logger?: Logger): Promise<AwsCommandResult<{
+    Messages: Array<{
+        MessageId: string;
+        ReceiptHandle: string;
+        Body: string;
+        Attributes?: Record<string, string>;
+    }>;
+}>>;
+export declare function purgeSQSQueue(options: SQSPurgeQueueOptions, logger?: Logger): Promise<AwsCommandResult<void>>;
+export {};