github-meta

This MCP server exposes tools for interacting with GitHub's API to create and update repositories. The primary tool, create_repo, accepts natural language commands to generate a repository with a derived name from a description, attach topics, set a homepage, and initialize it with a README. You can create new repositories by describing the project and including tags and a website, or update existing repositories by specifying the owner/repo and the field you want to modify (description, tags, or website). The tool interprets phrases like create/update, and supports multiple phrasings such as describe-to, tags-to, and website-to. This makes it convenient to manage GitHub repos directly through MCP conversations without switching to the GitHub UI.

Prerequisites:

• Node.js (recommended latest LTS) and npm installed on your system
• A GitHub personal access token with repository creation permissions

Install and build steps:

1. Clone the repository: git clone <repository-url>

2. Navigate to the project directory: cd <repository-directory>

3. Install dependencies: npm install

4. Build the server: npm run build

5. Set up configuration (example shown in README):

   • Create or modify your MCP settings file and add the following configuration for the github server:

     { "mcpServers": { "github": { "command": "node", "args": ["path/to/github-server/build/index.js"], "env": { "GITHUB_TOKEN": "your-github-token" } } } }

6. Run the MCP server as per your environment (node-based server would be started per your deployment setup).

Tips and notes:

• Ensure the GITHUB_TOKEN has repo creation permissions for the target account or organization.
• The tool will auto-generate a repository name from the provided description (e.g., my-machine-learning-image-classifier).
• Topics/tags are added as repository topics; provide space-separated or comma-separated lists depending on the command form.
• If updating a repository, provide the exact owner/repo format (owner/repo).
• When updating the website/homepage, pass a valid URL; the tool supports both http(s) URLs and GitHub Pages-like endpoints.
• If you encounter authentication or rate-limiting issues, verify token scopes and GitHub API access from the token used by GITHUB_TOKEN.
• For troubleshooting, check the MCP server logs for parsing of natural language commands and for any API errors returned by GitHub.