Code Summarizer

You run an MCP server that exposes your code summaries to integrated LLM tools, enabling powerful, on-demand code understanding via Claude Desktop, Cursor AI, Cline, and similar clients. It handles code discovery, summarization via Gemini Flash 2.0, and secure, configurable access for your tooling ecosystem.

How to use

You connect an MCP client to the code summarizer server to request file or directory summaries, navigate your codebase, and perform batch or targeted queries. Use the http endpoint for remote access or run the server locally for development and testing. Authentication is enforced with an API key, so include your key in request headers to access summaries and file contents.

How to install

# Prerequisites
Node.js 18+

# 1) Clone the project
git clone https://github.com/nicobailon/code-summarizer.git
cd code-summarizer

# 2) Install dependencies
npm install

# 3) Create environment configuration (Google API key required)
echo "GOOGLE_API_KEY=your_api_key_here" > .env

# 4) Build the project
npm run build

# 5) Start the MCP server (default port 24312)
npm start -- server
```} ,{

Additional sections

Configuration and security are designed to be straightforward and robust. You can customize the MCP server port, manage API keys, and control details for code summaries. The server exposes a structured set of resources, tools, and prompts to support varied usage scenarios while maintaining secure access.

MCP server configuration and access

You can access the MCP server in two common ways: via a remote http endpoint or by running the server locally as a stdio process. The following configurations are explicitly shown for these access methods.

Security and access control

All MCP server endpoints (except health) require authentication through an API key provided in the x-api-key header. Keys are verified, never logged, and can be sourced from environment variables for secure management. The server supports rate limiting and automatic retries with backoff for LLM interactions to prevent abuse and improve resilience.

Available tools

summarize_file

Summarize a single file with options and return a summary.

summarize_directory

Summarize multiple files within a directory, with options for detail and length.

set_config

Update configuration options for the MCP server, such as detail level, max length, and port.