Akave MCP Server

Instructions

Implementation Reference

• src/server.ts:203-208 (handler)

  The MCP tool handler for 'fetch_headers' which invokes the S3 client's fetchHeaders method and formats the response as MCP content.

  async ({ bucket, key }) => {
    const headers = await this.s3Client.fetchHeaders(bucket, key);
    return {
      content: [{ type: "text", text: JSON.stringify(headers) }],
    };
  }

• src/server.ts:199-202 (schema)

  Zod input schema defining the parameters for the 'fetch_headers' tool: bucket and key.

  {
    bucket: z.string().describe("Bucket name"),
    key: z.string().describe("Object key"),
  },

• src/server.ts:196-209 (registration)

  Registration of the 'fetch_headers' MCP tool including name, description, schema, and handler function.

  this.server.tool(
    "fetch_headers",
    "Fetch headers/metadata for an object",
    {
      bucket: z.string().describe("Bucket name"),
      key: z.string().describe("Object key"),
    },
    async ({ bucket, key }) => {
      const headers = await this.s3Client.fetchHeaders(bucket, key);
      return {
        content: [{ type: "text", text: JSON.stringify(headers) }],
      };
    }
  );

• src/s3Client.ts:132-138 (helper)

  Helper function in S3Client that performs a HeadObjectCommand to retrieve object metadata/headers.

  async fetchHeaders(bucket: string, key: string) {
    const command = new HeadObjectCommand({
      Bucket: bucket,
      Key: key,
    });
    return await this.client.send(command);
  }