starghlist

starghlist is an MCP server that helps you manage your GitHub starred repositories and create lists. It exposes tools to fetch your starred repos, star new ones, unstar existing ones, and retrieve your lists. An AI agent can view, sort, and filter repositories and suggest categorization based on your GitHub lists. Note that adding or removing repositories from lists is a work-in-progress, so use the available tools to manage stars and view lists. To run the server, you’ll need a valid GitHub Personal Access Token (PAT) and the SSE transport, and you’ll connect to the server at the provided endpoint. Once running, you can use the documented tools to interact with your GitHub stars and lists through the MCP interface.

Prerequisites:

• Go (Golang) installed on your system
• A GitHub Personal Access Token (PAT) with the necessary scopes to read and modify stars and lists

Step-by-step installation:

1. Ensure Go is installed
   • macOS: brew install go
   • Windows: download from https://golang.org/dl/
   • Linux: sudo apt-get install golang
2. Clone the MCP server repository (or download the source)
   • git clone https://github.com/yourorg/starghlist (replace with actual repo URL)
   • cd starghlist
3. Set your GitHub PAT in the environment when running, or export it in your shell
   • export GITHUB_TOKEN=your_pat_here
4. Run the server
   • go run *.go This starts the MCP server using the SSE transport on localhost:24240 by default.
5. (Optional) Build a binary for easier deployment
   • go build -o starghlist *.go
   • ./starghlist

Note: If you plan to run in a container or production environment, consider creating a small wrapper script to export GITHUB_TOKEN and start the binary.

Tips and notes:

• The server communicates via SSE; ensure your client supports SSE transport.
• Your GitHub PAT must have scopes to read starred repositories and manage lists if those features are enabled in the future.
• Initially, you can fetch stars with getStars, star new repos with addStar, unstar with removeStar, and retrieve lists with getListNames.
• The addToList and removeFromList features are marked as TODO/WIP in the README, so imported behavior may be limited until those features are implemented.
• When running locally, ensure port 24240 is accessible or configure the server to listen on a different port if needed. The example uses localhost:24240.
• If you encounter token or permission issues, verify that GITHUB_TOKEN is correctly exported and has the required scopes.