MCP server for comprehensive GitHub repository analysis using Gemini AI
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"codeglance-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# CodeGlance MCP Server An MCP (Model Context Protocol) server that analyzes GitHub repositories using Gemini AI and generates comprehensive documentation — project overviews, architecture guides, file insights, and more. Works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, etc. ## Quick Start ### 1. Get a Gemini API Key Get a free API key from [Google AI Studio](https://aistudio.google.com/app/apikey). ### 2. Install & Configure #### Claude Code ```bash claude mcp add codeglance -e GEMINI_API_KEY=your_key_here -- uvx codeglance-mcp ``` That's it. Verify with: ```bash claude mcp list ``` #### Claude Desktop / Cursor / Other MCP Clients Add to your MCP config file (`claude_desktop_config.json`, `.cursor/mcp.json`, etc.): ```json { "mcpServers": { "codeglance": { "command": "uvx", "args": ["codeglance-mcp"], "env": { "GEMINI_API_KEY": "your_gemini_api_key_here" } } } } ``` #### Alternative: Install via pip ```bash pip install codeglance-mcp ``` Then configure your MCP client to run `codeglance-mcp` as the command instead of `uvx codeglance-mcp`. ## What It Does When you ask your AI assistant to analyze a repository, CodeGlance: 1. **Clones** the repository (shallow clone for speed) 2. **Reads** key files (README, package.json, config files, entry points) 3. **Sends** the context to Gemini AI with specialized analysis prompts 4. **Generates** 6 documentation files in `codeglance-analysis/guide/` ### Generated Documentation | File | Description | |------|-------------| | `01-overview.md` | 5-minute project overview | | `02-tree.md` | Annotated directory structure | | `03-file-insights.md` | Key files and their purposes | | `04-architecture.md` | System architecture deep-dive | | `05-quick-start.md` | Getting started guide | | `06-master-analysis.md` | Comprehensive technical analysis | ## MCP Tools | Tool | Description | |------|-------------| | `analyze_repository` | Run…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.