Add starred repository support to GitHub MCP server #1078

Copilot · 2025-09-11T14:19:50Z

This PR implements comprehensive starred repository functionality for the GitHub MCP server, addressing the feature request to enable agents to search and manage starred repositories.

Also removes the github-mcp-server binary, which prob was accidentally commited.

What's Added

New Tools

list_starred_repositories - Lists starred repositories for the authenticated user or a specified user

Optional username parameter to list starred repos for any user
Sorting options by created (when starred) or updated (when repo was last pushed)
Standard pagination support
Returns repositories in MinimalRepository format with additional starred_at field

star_repository - Stars a repository

Requires owner and repo parameters
Returns success confirmation message

unstar_repository - Unstars a repository

Requires owner and repo parameters
Returns success confirmation message

Implementation Details

All tools follow existing patterns and use the same error handling approach
Added starred_at field to MinimalRepository struct to track when repositories were starred 🔴
Tools are registered in the repos toolset (read-only for listing, write tools for starring/unstarring)
Comprehensive test coverage with mocked HTTP clients following existing test patterns
Updated README documentation with complete parameter descriptions

Use Cases

This enables powerful agent workflows like:

"Show me my starred Python projects that have been updated recently"
"Star the facebook/react repository for future reference"
"List repositories that @transitive-bullshit has starred, sorted by star count"
"Find my starred machine learning repositories with more than 1000 stars"

API Coverage

Implements GitHub's starred repository REST API endpoints:

GET /user/starred - List starred repositories for authenticated user
GET /users/{username}/starred - List starred repositories for specific user
PUT /user/starred/{owner}/{repo} - Star a repository
DELETE /user/starred/{owner}/{repo} - Unstar a repository

The implementation enables agents to leverage users' curated collections of starred repositories as a high-quality signal for dependency selection and project discovery, as mentioned in the original issue.

Additional instructions:

Please take the comments as example and find suitable api endpoints to build the tool from.

write tests

update the readme doc

Fixes #414

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Co-authored-by: tonytrg <[email protected]>

- Add ListStarredRepositories tool for listing starred repos - Add StarRepository tool for starring repositories - Add UnstarRepository tool for unstarring repositories - Update MinimalRepository struct with StarredAt field - Add comprehensive test coverage for all new functionality - Register new tools in the repos toolset Co-authored-by: tonytrg <[email protected]>

- Add list_starred_repositories tool documentation - Add star_repository tool documentation - Add unstar_repository tool documentation - Include comprehensive parameter descriptions for all new tools Co-authored-by: tonytrg <[email protected]>

Co-authored-by: tonytrg <[email protected]>

nshaikh99 · 2025-09-11T22:32:15Z

Preparing review...

nshaikh99 · 2025-09-11T22:35:27Z

Preparing review...

nshaikh99 · 2025-09-11T22:41:24Z

Preparing review...

nshaikh99 · 2025-09-11T22:44:10Z

Preparing review...

nshaikh99 · 2025-09-11T22:44:41Z

Preparing review...

nshaikh99 · 2025-09-11T23:03:07Z

Preparing review...

nshaikh99 · 2025-09-11T23:04:48Z

Preparing review...

nshaikh99 · 2025-09-11T23:06:26Z

Preparing review...

nshaikh99 · 2025-09-11T23:07:01Z

Preparing review...

Copilot

Pull Request Overview

This PR implements comprehensive starred repository functionality for the GitHub MCP server, enabling agents to search and manage starred repositories through natural language interactions.

Adds three new tools: list_starred_repositories, star_repository, and unstar_repository
Enables listing starred repositories for authenticated users or specific users with pagination and sorting options
Provides tools to star and unstar repositories with proper error handling
Updates the MinimalRepository struct with starred_at field for tracking when repositories were starred

Reviewed Changes

Copilot reviewed 7 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
pkg/github/tools.go	Registers the new starred repository tools in the repos toolset
pkg/github/repositories.go	Implements the three new starred repository functions with GitHub API integration
pkg/github/repositories_test.go	Adds comprehensive test coverage for all three new tools
pkg/github/toolsnaps/*.snap	Creates tool snapshots for testing and validation
README.md	Documents the new tools with parameter descriptions

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-09-12T12:50:35Z

pkg/github/repositories.go

+			// Convert to minimal format
+			minimalRepos := make([]MinimalRepository, 0, len(repos))
+			for _, starredRepo := range repos {
+				repo := starredRepo.Repository
+				minimalRepo := MinimalRepository{
+					ID:            repo.GetID(),
+					Name:          repo.GetName(),
+					FullName:      repo.GetFullName(),
+					Description:   repo.GetDescription(),
+					HTMLURL:       repo.GetHTMLURL(),
+					Language:      repo.GetLanguage(),
+					Stars:         repo.GetStargazersCount(),
+					Forks:         repo.GetForksCount(),
+					OpenIssues:    repo.GetOpenIssuesCount(),
+					Private:       repo.GetPrivate(),
+					Fork:          repo.GetFork(),
+					Archived:      repo.GetArchived(),
+					DefaultBranch: repo.GetDefaultBranch(),
+				}
+
+				if repo.UpdatedAt != nil {
+					minimalRepo.UpdatedAt = repo.UpdatedAt.Format("2006-01-02T15:04:05Z")
+				}
+
+				minimalRepos = append(minimalRepos, minimalRepo)
+			}


The MinimalRepository struct is missing a StarredAt field that should be populated from starredRepo.StarredAt. The PR description mentions adding a starred_at field to track when repositories were starred, but this field is not being set in the conversion logic.

tonytrg · 2025-09-12T12:53:58Z

I removed the starred_at attribute from the minimal struct as i dont think this field is really needed often in 99% of all cases.

khowhom172-del · 2025-09-16T07:31:12Z

This PR implements comprehensive starred repository functionality for the GitHub MCP server, addressing the feature request to enable agents to search and manage starred repositories.

Also removes the github-mcp-server binary, which prob was accidentally commited.

What's Added

New Tools

list_starred_repositories - Lists starred repositories for the authenticated user or a specified user

Optional username parameter to list starred repos for any user

Sorting options by created (when starred) or updated (when repo was last pushed)

Standard pagination support

Returns repositories in MinimalRepository format with additional starred_at field

star_repository - Stars a repository

Requires owner and repo parameters

Returns success confirmation message

unstar_repository - Unstars a repository

Requires owner and repo parameters

Returns success confirmation message

Implementation Details

All tools follow existing patterns and use the same error handling approach

Added starred_at field to MinimalRepository struct to track when repositories were starred 🔴

Tools are registered in the repos toolset (read-only for listing, write tools for starring/unstarring)

Comprehensive test coverage with mocked HTTP clients following existing test patterns

Updated README documentation with complete parameter descriptions

Use Cases

This enables powerful agent workflows like:
"Show me my starred Python projects that have been updated recently"
"Star the facebook/react repository for future reference"
"List repositories that @transitive-bullshit has starred, sorted by star count"
"Find my starred machine learning repositories with more than 1000 stars"
API Coverage

Implements GitHub's starred repository REST API endpoints:

GET /user/starred - List starred repositories for authenticated user

GET /users/{username}/starred - List starred repositories for specific user

PUT /user/starred/{owner}/{repo} - Star a repository

DELETE /user/starred/{owner}/{repo} - Unstar a repository

The implementation enables agents to leverage users' curated collections of starred repositories as a high-quality signal for dependency selection and project discovery, as mentioned in the original issue.

Additional instructions:

Please take the comments as example and find suitable api endpoints to build the tool from.

write tests

update the readme doc

Fixes #414

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

khowhom172-del · 2025-09-16T07:31:18Z

vf

* Initial plan * Initial exploration and planning for starred repository support Co-authored-by: tonytrg <[email protected]> * Implement starred repository functionality with comprehensive tests - Add ListStarredRepositories tool for listing starred repos - Add StarRepository tool for starring repositories - Add UnstarRepository tool for unstarring repositories - Update MinimalRepository struct with StarredAt field - Add comprehensive test coverage for all new functionality - Register new tools in the repos toolset Co-authored-by: tonytrg <[email protected]> * Update README documentation with starred repository tools - Add list_starred_repositories tool documentation - Add star_repository tool documentation - Add unstar_repository tool documentation - Include comprehensive parameter descriptions for all new tools Co-authored-by: tonytrg <[email protected]> * Add starred repository support to GitHub MCP server Co-authored-by: tonytrg <[email protected]> * remove starredat from minimal view * update descriptions * remove bin * dont commit the binary --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: tonytrg <[email protected]> Co-authored-by: tonytrg <[email protected]>

Initial plan

7912b96

Copilot AI assigned Copilot and tonytrg Sep 11, 2025

Copilot started work on behalf of tonytrg September 11, 2025 14:19 View session

Copilot AI and others added 4 commits September 11, 2025 14:23

Initial exploration and planning for starred repository support

4742fa6

Co-authored-by: tonytrg <[email protected]>

Add starred repository support to GitHub MCP server

4599a2b

Co-authored-by: tonytrg <[email protected]>

Copilot AI changed the title ~~[WIP] Starred repo support~~ Add starred repository support to GitHub MCP server Sep 11, 2025

Copilot AI requested a review from tonytrg September 11, 2025 14:35

Copilot finished work on behalf of tonytrg September 11, 2025 14:35

tonytrg added 4 commits September 12, 2025 14:39

remove starredat from minimal view

3f201f3

update descriptions

1cd7b74

remove bin

9145f8d

dont commit the binary

bee9324

tonytrg marked this pull request as ready for review September 12, 2025 12:49

tonytrg requested a review from a team as a code owner September 12, 2025 12:49

Copilot AI review requested due to automatic review settings September 12, 2025 12:49

Copilot AI reviewed Sep 12, 2025

View reviewed changes

tonytrg approved these changes Sep 12, 2025

View reviewed changes

tonytrg merged commit 010cf9b into main Sep 12, 2025
16 checks passed

tonytrg deleted the copilot/fix-8d6e5df9-0eeb-4cf4-8638-d63fe34060bb branch September 12, 2025 14:11

BrewTestBot mentioned this pull request Sep 12, 2025

github-mcp-server 0.15.0 Homebrew/homebrew-core#239458

Merged

Add starred repository support to GitHub MCP server #1078

Add starred repository support to GitHub MCP server #1078

Uh oh!

Conversation

Copilot AI commented Sep 11, 2025 • edited by tonytrg Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What's Added

New Tools

Implementation Details

Use Cases

API Coverage

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

nshaikh99 commented Sep 11, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Sep 12, 2025

Choose a reason for hiding this comment

Uh oh!

tonytrg commented Sep 12, 2025

Uh oh!

Uh oh!

khowhom172-del commented Sep 16, 2025

What's Added

New Tools

Implementation Details

Use Cases

API Coverage

Uh oh!

khowhom172-del commented Sep 16, 2025

Uh oh!

Uh oh!

Copilot AI commented Sep 11, 2025 •

edited by tonytrg

Loading