AWS MCP Server

Instructions

Implementation Reference

• src/index.ts:1737-1777 (handler)

  Executes the get_recent_logs tool: fetches the latest log stream from the specified CloudWatch Log Group and retrieves the most recent log events using AWS CloudWatchLogsClient.

  if (name === "get_recent_logs") {
      const groupName = (args as any).log_group_name;
      const limit = (args as any)?.limit || 20;
  
      // Get latest stream
      const streamCmd = new DescribeLogStreamsCommand({
          logGroupName: groupName,
          orderBy: "LastEventTime",
          descending: true,
          limit: 1
      });
  
      try {
          const streamResp = await cloudWatchLogsClient.send(streamCmd);
          const streamName = streamResp.logStreams?.[0]?.logStreamName;
  
          if (!streamName) {
              return { content: [{ type: "text", text: "No log streams found." }] };
          }
  
          const eventsCmd = new GetLogEventsCommand({
              logGroupName: groupName,
              logStreamName: streamName,
              limit: limit,
              startFromHead: false
          });
          const eventsResp = await cloudWatchLogsClient.send(eventsCmd);
  
          const logs = eventsResp.events?.map(e => ({
              Timestamp: new Date(e.timestamp || 0).toISOString(),
              Message: e.message
          })) || [];
  
          return {
              content: [{ type: "text", text: JSON.stringify(logs, null, 2) }]
          };
  
      } catch (err: any) {
          return { content: [{ type: "text", text: `Error fetching logs: ${err.message}` }], isError: true };
      }
  }

• src/index.ts:464-481 (registration)

  Registers the 'get_recent_logs' tool in the ListTools response, defining its name, description, and input schema.

  {
      name: "get_recent_logs",
      description: "Retrieves recent log events from a CloudWatch Log Group.",
      inputSchema: {
          type: "object",
          properties: {
              log_group_name: {
                  type: "string",
                  description: "Name of the Log Group."
              },
              limit: {
                  type: "number",
                  description: "Number of log events to return (default: 20)."
              }
          },
          required: ["log_group_name"]
      }
  },

• src/index.ts:467-480 (schema)

  Defines the input schema for the get_recent_logs tool, specifying required log_group_name and optional limit.

  inputSchema: {
      type: "object",
      properties: {
          log_group_name: {
              type: "string",
              description: "Name of the Log Group."
          },
          limit: {
              type: "number",
              description: "Number of log events to return (default: 20)."
          }
      },
      required: ["log_group_name"]
  }