How do I use git-repo-brief?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@git-repo-brief give me a brief of https://github.com/facebook/react" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

git-repo-brief

Q: Which integrations are available for this server?

Provides tools to retrieve repository overview, key files, release notes, and activity snapshots from public GitHub repositories via the GitHub API.

by BUZDOLAPCI

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

git-repo-brief

An MCP (Model Context Protocol) server that generates structured briefs for public GitHub repositories. Get comprehensive repository information including overview, key files, release notes, and activity snapshots.

Features

repo_overview: Get repository metadata (name, description, stars, forks, language, topics, license, timestamps)
extract_key_files: Fetch contents of key files (README.md, LICENSE, package.json, pyproject.toml)
release_notes: Get recent release notes with tag names, descriptions, and dates
activity_snapshot: Get activity metrics (last commit, open issues/PRs, contributors count)

Related MCP server: gts-repo-guardian

Installation

npm install
npm run build

Usage

As MCP Server (stdio mode)

# Run directly
npm start

# Or after building
node dist/cli.js

As HTTP Server

npm start -- --http
# or
HTTP_PORT=3001 node dist/cli.js --http

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "git-repo-brief": {
      "command": "node",
      "args": ["/path/to/git-repo-brief/dist/cli.js"]
    }
  }
}

Tools

repo_overview

Get a comprehensive overview of a GitHub repository.

Input:

{
  "repo_url": "https://github.com/owner/repo"
}

Output:

{
  "ok": true,
  "data": {
    "name": "repo",
    "full_name": "owner/repo",
    "description": "Repository description",
    "stars": 1234,
    "forks": 567,
    "language": "TypeScript",
    "topics": ["mcp", "github"],
    "license": "MIT",
    "created_at": "2023-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z",
    "default_branch": "main",
    "homepage": "https://example.com",
    "owner": {
      "login": "owner",
      "avatar_url": "https://github.com/owner.png",
      "type": "User"
    }
  },
  "meta": {
    "source": "https://api.github.com/repos/owner/repo",
    "retrieved_at": "2024-01-15T10:00:00Z",
    "pagination": { "next_cursor": null },
    "warnings": []
  }
}

extract_key_files

Fetch contents of key files from a repository.

Input:

{
  "repo_url": "https://github.com/owner/repo",
  "paths": ["README.md", "package.json"]
}

Output:

{
  "ok": true,
  "data": {
    "files": [
      {
        "path": "README.md",
        "content": "# Project\n\nDescription...",
        "size": 1234,
        "encoding": "utf-8"
      },
      {
        "path": "package.json",
        "content": "{\"name\": \"project\"}",
        "size": 456,
        "encoding": "utf-8"
      }
    ],
    "default_branch": "main"
  },
  "meta": {
    "retrieved_at": "2024-01-15T10:00:00Z",
    "warnings": []
  }
}

release_notes

Get recent release notes from a repository.

Input:

{
  "repo_url": "https://github.com/owner/repo",
  "limit": 5
}

Output:

{
  "ok": true,
  "data": {
    "releases": [
      {
        "tag_name": "v1.0.0",
        "name": "Version 1.0.0",
        "body": "## Changes\n- Feature A\n- Bug fix B",
        "published_at": "2024-01-01T00:00:00Z",
        "prerelease": false,
        "draft": false,
        "html_url": "https://github.com/owner/repo/releases/tag/v1.0.0"
      }
    ],
    "total_count": 1
  },
  "meta": {
    "retrieved_at": "2024-01-15T10:00:00Z",
    "pagination": { "next_cursor": null },
    "warnings": []
  }
}

activity_snapshot

Get a snapshot of recent repository activity.

Input:

{
  "repo_url": "https://github.com/owner/repo"
}

Output:

{
  "ok": true,
  "data": {
    "last_commit_date": "2024-01-14T15:30:00Z",
    "last_commit_message": "fix: resolve parsing issue",
    "open_issues_count": 25,
    "open_prs_count": 8,
    "contributors_count": 42,
    "watchers_count": 100,
    "has_wiki": true,
    "has_discussions": true
  },
  "meta": {
    "retrieved_at": "2024-01-15T10:00:00Z",
    "warnings": []
  }
}

HTTP API Endpoints

When running in HTTP mode:

GET /health - Health check
GET /tools - List available tools
POST /tools/repo_overview - Get repository overview
POST /tools/extract_key_files - Extract key files
POST /tools/release_notes - Get release notes
POST /tools/activity_snapshot - Get activity snapshot

Example HTTP Request

curl -X POST http://localhost:3000/tools/repo_overview \
  -H "Content-Type: application/json" \
  -d '{"repo_url": "https://github.com/microsoft/vscode"}'

Configuration

Environment Variables

Variable	Default	Description
`GITHUB_TOKEN`	-	GitHub personal access token (optional, increases rate limit from 60 to 5000 req/hour)
`REQUEST_DELAY_MS`	100	Delay between requests for rate limiting
`REQUEST_TIMEOUT_MS`	30000	Request timeout in milliseconds
`TRANSPORT_MODE`	stdio	Transport mode: `stdio` or `http`
`HTTP_PORT`	3000	HTTP server port (when using HTTP transport)

Rate Limiting

The server implements polite rate limiting:

Default delay of 100ms between requests
Handles GitHub API rate limit responses gracefully
Optional GitHub token support for higher rate limits

Response Format

All responses follow the standard envelope format:

Success Response

{
  "ok": true,
  "data": { ... },
  "meta": {
    "source": "optional API URL",
    "retrieved_at": "ISO-8601 timestamp",
    "pagination": { "next_cursor": null },
    "warnings": []
  }
}

Error Response

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT | UPSTREAM_ERROR | RATE_LIMITED | TIMEOUT | PARSE_ERROR | INTERNAL_ERROR",
    "message": "Human readable message",
    "details": { ... }
  },
  "meta": {
    "retrieved_at": "ISO-8601 timestamp"
  }
}

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Type check
npm run typecheck

# Build
npm run build

Testing

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run with coverage
npm run test:coverage

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

gread A
io.github.NitroRCr
An MCP server that gives your AI access to the source code and docs of all public github repos
Version Control Code Analysis Documentation Access
5361
Meeba Brain A
io.github.meemoprasad
Repository knowledge graph MCP server for codebase understanding and debugging.
Code Analysis Developer Tools
51
neverinfamous-memory-journal-mcp
ai.smithery
A MCP server built for developers enabling Git based project management with project and personal…
Version Control Developer Tools Project Management
320
ArletOAuth
dev.arlet
Create, deploy, and operate MCP servers directly from your GitHub repositories.
Developer Tools CI/CD & DevOps
2

Related MCP Servers

Code Understanding MCP Server
Code Analysis Version Control Developer Tools
codingthefuturewithai
A
license
C
quality
D
maintenance
An MCP server that analyzes local or remote GitHub repositories, providing intelligent code context and structure to AI coding assistants.
Updated 9 months ago (2025-12-23 19:30 UTC)
10
13
MIT
gts-repo-guardian
Version Control Developer Tools Code Analysis
planetazuzu
F
license
A
quality
D
maintenance
MCP server for automated GitHub repository quality management, enabling review, README generation, cleanup, and monitoring.
Updated 6 months ago (2026-03-02 12:08 UTC)
6
-
github-repo-intel-mcp
Version Control Developer Tools
heisencodex-jpg
A
license
Not graded
quality
D
maintenance
Provides AI coding agents with structured intelligence about any GitHub repository including overview, PRs, contributors, hot files, CI status, and dependencies via a hosted MCP endpoint.
Updated 4 months ago (2026-05-21 08:26 UTC)
18 npm
MIT
repo-doctorofficial
Version Control Code Analysis Developer Tools
Infojitsu
A
license
Not graded
quality
C
maintenance
MCP server that produces scored, evidence-cited audits of public GitHub repos via tools for fetching metadata, reading files, scanning git history, and checking hygiene.
Updated a month ago (2026-08-01 19:45 UTC)
MIT

git-repo-brief

Features

Installation

Usage

As MCP Server (stdio mode)

As HTTP Server

MCP Client Configuration

Tools

repo_overview

extract_key_files

release_notes

activity_snapshot

HTTP API Endpoints

Example HTTP Request

Configuration

Environment Variables

Rate Limiting

Response Format

Success Response

Error Response

Development

Testing

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Code Understanding MCP Server

gts-repo-guardian

github-repo-intel-mcp

repo-doctorofficial