Weather/GitHub MCP Server

by guptarajiv535

324 downloads
Not rated
GitHub

About

A GitHub MCP server that provides tools to interact with GitHub repositories and issues. It uses the MCP protocol with FastMCP and is intended for developers who need programmatic access to GitHub data via an MCP-compatible client like Cursor.

Details

Author
guptarajiv535
Downloads
324
Categories
Developer Tools

- List public repositories for a GitHub user
- List issues for a repository
- Create issues in a repository
- Requires Python 3.10 or newer and uv
- Uses a GitHub personal access token for authentication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Weather/GitHub MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with uv run github.py (from the project directory), and set your GITHUB_TOKEN as an environment variable or in a .env file. The server can then be configured in your Cursor or MCP client’s mcp.json file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "weather/github mcp server": {
            "MCP_SERVER_PYTHON_POC": {
                "command": "uv",
                "args": [
                    "init",
                    "mcp-server-demo"
                ]
            }
        }
    }
}

McpServers

{
    "MCP_SERVER_PYTHON_POC": {
        "command": "uv",
        "args": [
            "init",
            "mcp-server-demo"
        ]
    }
}

Weather/GitHub MCP Server

This project provides a GitHub MCP server with tools to interact with GitHub repositories and issues.

Requirements

- Python 3.10 or newer - uv (a fast Python package/dependency manager) - A GitHub personal access token (for creating issues)

Setup & Usage

1. Clone this repository and install dependencies using uv:

uv init mcp-server-demo
cd mcp-server-demo
uv run ../github.py

Or, if you are already in the project directory:

uv run github.py

2. Set your GitHub token:

Create a .env file in the project root with:

GITHUB_TOKEN=your_personal_access_token_here

Or export it in your shell:

export GITHUB_TOKEN=your_personal_access_token_here

Features

- List public repositories for a GitHub user - List issues for a repository - Create issues in a repository

Notes

- Make sure your token has the correct permissions for repository and issue access. - The server runs using the MCP protocol with FastMCP.

Configuring MCP Servers

To make your MCP server available in Cursor, configure it in your ~/.cursor/mcp.json file. Example configuration:

{
  "mcpServers": {
    "github": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/github-mcp-demo",
        "run",
        "github.py"
      ]
    }
  }
}

This tells Cursor how to start your MCP server and what command to use.

Example: Cursor Settings UI

Below is a screenshot showing the MCP server available in Cursor:

MCP Server Status in Cursor

Cursor shows your configured MCP servers in the curso settings UI, indicating whether each server is ON (enabled) or OFF (disabled). This helps you quickly see which tools are available.

Add your screenshot below to illustrate this:

Cursor MCP Server ON/OFF Status

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.