Code Summarizer

What is Code Summarizer?

A command-line and MCP server tool that recursively summarizes code files in a given directory using Google Gemini Flash 2.0. It integrates with LLM tools like Claude Desktop, Cursor AI, and Cline, and is designed for developers who want to quickly understand codebases without manual reading.

How to use Code Summarizer?

Install Node.js 18+, clone the repository, install dependencies, configure a GOOGLE_API_KEY environment variable, then use the CLI with npm start -- summarize [directory] or start the MCP server with npm start -- server. The server port (default 24312) can be changed via npm start -- config set --port 8080. Connect LLM tools by setting up a JSON config file or using SSE transport with an API key header.

Key features of Code Summarizer

• Recursively processes code files respecting .gitignore rules.
• Uses Gemini Flash 2.0 for summarization.
• Configurable detail level and summary length.
• MCP server integration with Claude Desktop, Cursor AI, and Cline.
• Retry mechanism with exponential backoff and jitter.
• Built-in rate limiting (default 60 requests per minute per IP).

Use cases of Code Summarizer

• Quickly understand the structure and purpose of a new codebase.
• Get concise summaries of specific files without opening them.
• Batch summarize multiple files in a directory.
• Search for patterns or functionality using targeted queries.
• Integrate code knowledge into LLM chat sessions for more informed assistance.

FAQ from Code Summarizer

What are the system requirements?

Node.js 18 or later is required.

How do I authenticate with the MCP server?

Include your API key in the x-api-key header of all requests (except the /health endpoint).

What should I do if I get a "Connection Refused" error?

Ensure the MCP server is running (npm start -- server), verify the port is correct in your configuration, and check for firewall issues.

How do I connect Code Summarizer with Claude Desktop?

Start the MCP server, then create or edit claude_desktop_config.json with the correct path to the server binary and your GOOGLE_API_KEY environment variable, then restart Claude Desktop.

Does Code Summarizer have rate limiting?

Yes, it has a default limit of 60 requests per minute per IP address, which can be configured in the server settings.