mcp CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What This Is

This is the @img-src/mcp-server — an MCP (Model Context Protocol) server that enables AI assistants to interact with the img-src.io image processing API programmatically.

Commands

pnpm install          # Install dependencies
pnpm build            # Build TypeScript to dist/
pnpm start            # Start MCP server (stdio transport)
pnpm test             # Run tests with Vitest
pnpm type-check       # TypeScript type checking
pnpm lint             # ESLint

CI Checks (what PR builds run)

pnpm build && pnpm lint && pnpm type-check && pnpm test

CI matrix: Node.js 20, 22 on ubuntu-latest.

Architecture

Single-file Structure

src/
├── index.ts          # Main MCP server implementation
└── index.test.ts     # Tests

Key Dependencies

• @modelcontextprotocol/sdk — MCP SDK for server implementation
• zod — Runtime schema validation

Available Tools

Tool	Description
upload_image	Upload image from local file or URL
list_images	List images in folder with pagination
search_images	Search by filename/path
get_image	Get image metadata by ID
delete_image	Delete an image
get_usage	View usage statistics
get_settings	Get account settings
get_cdn_url	Generate CDN URL with transformations

Configuration

The server requires IMG_SRC_API_KEY environment variable:

{
  "mcpServers": {
    "img-src": {
      "command": "npx",
      "args": ["@img-src/mcp-server"],
      "env": {
        "IMG_SRC_API_KEY": "imgsrc_your_api_key"
      }
    }
  }
}

Testing

Uses Vitest for testing. Tests mock the MCP SDK and HTTP requests.

pnpm test                    # Run all tests
pnpm test -- --watch         # Watch mode

CD/Publishing

The server is published to npm automatically when a git tag is pushed.