Github Repo Creator

Analyzes local repos, generates metadata, and creates private GitHub repositories with topics and configuration.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "flickleafy-mcp-github-repo-creator": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You can use the MCP GitHub Repository Creator to analyze a local repository, generate metadata, and automatically create a private GitHub repository with appropriate configuration. This server enables end-to-end automation from repository analysis to GitHub setup, making it easier to publish and organize projects with consistent topics and settings.

How to use

You connect an MCP client to this server to perform end-to-end repository setup. Start by launching the MCP server locally, then use its tools to analyze your repository, generate a metadata file, and create a GitHub repository. You can run the workflow in interactive mode with Copilot or opt for a fully automated sequence.

How to install

Prerequisites: Python 3.8 or newer, Git, and the GitHub CLI (gh) installed and authenticated. You will also need a local git repository to analyze.

Step-by-step commands to set up and run the MCP server locally:

# Activate a Python virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Start the MCP server
python server.py

Additional steps and notes

The server exposes tools to analyze a repository, generate repository metadata, and create a GitHub repository with proper configuration. Ensure you are in a valid Git repository with commits before running analysis. The server creates private repositories by default and configures topics based on analysis.

Security and requirements

The workflow relies on the GitHub CLI for repository creation and authentication. Ensure gh is installed and you are authenticated before proceeding.
All repository analysis occurs locally; no sensitive data leaves your machine.

Troubleshooting

If you encounter issues, verify you are running inside a git repository with commits, ensure the GitHub CLI is authenticated (gh auth login), and check that the server is running in the active virtual environment.

Available tools

get_repo_analysis_instructions

Fetch detailed instructions for how to analyze the repository and what aspects to evaluate.

analyze_and_generate_metadata_file

Analyze the repository and generate a github_repo_metadata.json with repository details.

create_github_repo_from_metadata

Create a GitHub repository from the generated metadata JSON and apply initial configuration.

create_github_repository

Create a GitHub repository using an existing metadata file and connect the local repo.

full_repository_setup

Execute the complete workflow from analysis to GitHub repository creation and local push in one step.