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
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
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
Development/Unpublished Servers Configuration
{
"mcpServers": {
"mcp-github-trending": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-github-trending",
"run",
"mcp-github-trending"
]
}
}
}
Published Servers Configuration
{
"mcpServers": {
"mcp-github-trending": {
"command": "uvx",
"args": [
"mcp-github-trending"
]
}
}
}
Development
Building and Publishing
- Sync dependencies and update lockfile:
uv sync
- Build package distributions:
uv build
- 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.
