What is Mcp Github Trending

mcp-github-trending is an MCP server that provides access to trending repositories and developers on GitHub through a simple API interface.

Use cases

Use cases include identifying trending technologies, discovering popular repositories for collaboration, and analyzing developer activity over time.

How to use

To use mcp-github-trending, you can make API calls to retrieve trending repositories and developers. You can filter results by programming language, time period (daily, weekly, monthly), and spoken language.

Key features

Key features include access to GitHub trending repositories and developers data, filtering options by programming language, time period, and spoken language, and well-formatted JSON responses.

Where to use

mcp-github-trending can be used in software development, data analysis, and research to track popular repositories and developers in the GitHub ecosystem.

mcp-github-trending MCP Server

A MCP server that provides access to GitHub trending repositories and developers data through a simple API interface.

Features

• Access GitHub trending repositories and developers data
• Filter by programming language
• Filter by time period (daily, weekly, monthly)
• Filter by spoken language
• Returns well-formatted JSON responses

Tools

The server implements the following tools:

get_github_trending_repositories

Gets trending repositories from GitHub with the following parameters:

• language (optional): Programming language to filter repositories by (e.g. “python”, “javascript”)
• since (optional): Time period to filter repositories by (“daily”, “weekly”, “monthly”). Defaults to “daily”
• spoken_language (optional): Spoken language to filter repositories by

Example response:

[
  {
    "name": "repository-name",
    "fullname": "owner/repository-name",
    "url": "https://github.com/owner/repository-name",
    "description": "Repository description",
    "language": "Python",
    "stars": 1000,
    "forks": 100,
    "current_period_stars": 50
  }
]

get_github_trending_developers

Gets trending developers from GitHub with the following parameters:

• language (optional): Programming language to filter by (e.g. “python”, “javascript”)
• since (optional): Time period to filter by (“daily”, “weekly”, “monthly”). Defaults to “daily”

Example response:

[
  {
    "username": "developer",
    "name": "Developer Name",
    "url": "https://github.com/developer",
    "avatar": "https://avatars.githubusercontent.com/u/123456",
    "repo": {
      "name": "repository-name",
      "description": "Repository description",
      "url": "https://github.com/developer/repository-name"
    }
  }
]

Installation

Prerequisites

• Python 3.12

Install Steps

Install the package:

pip install mcp-github-trending

Claude Desktop Configuration

On MacOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-github-trending": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-github-trending",
        "run",
        "mcp-github-trending"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-github-trending": {
      "command": "uvx",
      "args": [
        "mcp-github-trending"
      ]
    }
  }
}

Development

Building and Publishing

1. Sync dependencies and update lockfile:

uv sync

2. Build package distributions:

uv build

3. Publish to PyPI:

uv publish

Note: Set PyPI credentials via environment variables or command flags:

• Token: --token or UV_PUBLISH_TOKEN
• Username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

For the best debugging experience, use the MCP Inspector.

Launch the MCP Inspector via npm:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-github-trending run mcp-github-trending

The Inspector will display a URL that you can access in your browser to begin debugging.

License

This project is licensed under the MIT License - see the LICENSE file for details.