Skip to main content
Glama

GitHub Stars MCP Server

by Dustyposa
Apache 2.0
1

GitHub Stars MCP Server

A high-performance Model Context Protocol (MCP) server for GitHub stars analysis and timeline tracking.

Overview

This MCP server provides tools for analyzing GitHub user starred repositories, offering insights into development trends, technology adoption patterns, and timeline analysis.

Features

  • GitHub Stars Analysis: Retrieve and analyze user starred repositories
  • Timeline Tracking: Track starring patterns over time
  • Technology Insights: Analyze technology trends from starred repositories
  • High Performance: Built with async/await patterns and Redis caching
  • GitHub App Authentication: Secure authentication using GitHub Apps

Technology Stack

  • Python 3.11+: Modern Python with type hints
  • FastMCP 2.2.0+: High-performance MCP framework
  • Pydantic 2.0+: Data validation and serialization
  • httpx: Async HTTP client for GitHub API
  • Redis 5.0+: Caching and performance optimization
  • GitHub GraphQL API: Efficient data retrieval
  • structlog: Structured logging

Installation

# Clone the repository git clone https://github.com/your-org/github-stars-mcp-server.git cd github-stars-mcp-server # Install dependencies using uv uv sync # Activate virtual environment source .venv/bin/activate

Configuration

Create a .env file with your GitHub App credentials:

GITHUB_APP_ID=your_app_id GITHUB_APP_PRIVATE_KEY_PATH=path/to/private-key.pem GITHUB_APP_INSTALLATION_ID=your_installation_id REDIS_URL=redis://localhost:6379

Usage

# Start the MCP server github-stars-mcp-server

Development

# Install development dependencies uv sync --dev # Run tests pytest # Run linting ruff check . # Run type checking mypy src/

Docker

# Build Docker image docker build -t github-stars-mcp-server . # Run container docker run -p 8000:8000 --env-file .env github-stars-mcp-server

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Run the test suite
  6. Submit a pull request

License

MIT License - see LICENSE file for details.

Architecture

This server follows a modular architecture:

  • src/github_stars_mcp_server/config.py: Configuration management
  • src/github_stars_mcp_server/models.py: Pydantic data models
  • src/github_stars_mcp_server/github_client.py: GitHub API client
  • src/github_stars_mcp_server/server.py: MCP server implementation
  • src/github_stars_mcp_server/tools/: MCP tools implementation

Performance

  • Async/await throughout for non-blocking operations
  • Redis caching for frequently accessed data
  • GraphQL for efficient API queries
  • Connection pooling for optimal resource usage

Security

  • GitHub App authentication for secure API access
  • Environment-based configuration
  • Input validation with Pydantic
  • Structured logging for audit trails
-
security - not tested
A
license - permissive license
-
quality - not tested

A high-performance server for analyzing GitHub user starred repositories, providing insights into development trends, technology adoption patterns, and timeline tracking.

  1. Overview
    1. Features
      1. Technology Stack
        1. Installation
          1. Configuration
            1. Usage
              1. Development
                1. Docker
                  1. Contributing
                    1. License
                      1. Architecture
                        1. Performance
                          1. Security

                            Related MCP Servers

                            • A
                              security
                              A
                              license
                              A
                              quality
                              Provides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.
                              Last updated -
                              46
                              37
                              37
                              TypeScript
                              MIT License
                            • A
                              security
                              F
                              license
                              A
                              quality
                              Provides tools for mapping and analyzing GitHub repositories. It allows users to set a GitHub Personal Access Token and retrieve detailed information about a specified repository, including its structure and summary statistics.
                              Last updated -
                              2
                              17
                              TypeScript
                            • A
                              security
                              F
                              license
                              A
                              quality
                              Generates comprehensive and formatted release notes from GitHub repositories, efficiently organizing commits by type and including detailed statistics using smart API usage.
                              Last updated -
                              3
                              2
                              TypeScript
                            • A
                              security
                              A
                              license
                              A
                              quality
                              A TypeScript server that analyzes GitHub Pull Requests using the Model-Controller-Presenter pattern.
                              Last updated -
                              1
                              5
                              TypeScript
                              MIT License

                            View all related MCP servers

                            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/Dustyposa/github-stars-mcp-server'

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