Skip to main content
Glama
hetaoBackend

mcp-github-trending

by hetaoBackend

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

Related MCP server: ossinsight-mcp

Tools

The server implements the following tools:

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
  }
]

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
  1. Build package distributions:

uv build
  1. 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.

Available Tools

2 tools

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • First observedget_github_trending_developers
    • First observedget_github_trending_repositories

TDQS

B3.2/5.0
Disambiguation5/5

The two tools have perfectly distinct purposes: one targets trending developers, the other trending repositories. There is no overlap in functionality, and an agent can easily differentiate between them based on the clear resource distinction.

Naming Consistency5/5

Both tools follow an identical verb_noun pattern with 'get_github_trending_' prefix, ensuring complete predictability. The naming is highly consistent and readable, with no deviations in style or structure.

Tool Count2/5

With only 2 tools, the server feels thin for its apparent scope of 'github-trending'. While it covers two key resources, the lack of filtering, sorting, or time-range options limits utility, making the count borderline insufficient for robust trending analysis.

Completeness3/5

The server provides basic access to trending developers and repositories, but there are notable gaps. Missing operations include filtering by language, location, or time period, and there is no way to get historical trending data or detailed analytics, which are common needs in this domain.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hetaoBackend/mcp-github-trending'

If you have feedback or need assistance with the MCP directory API, please join our Discord server