GitHub MCP Server
About
Interact with the GitHub API to create and manage repositories, including setting descriptions, topics, and website URLs.
Details
- Author
- PoliTwit1984
- Downloads
- 411
- Categories
- Developer Tools, Other, Project Management, Automation
Jump to
- Create GitHub repositories with auto-generated names from descriptions
- Add topics/tags to repositories
- Set repository homepages
- Auto-initialize repositories with README files
- Update existing repository descriptions, tags, and websites
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
GitHub MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies with npm install, build with npm run build, then configure the server in your MCP settings file with a GitHub personal access token (GITHUB_TOKEN). Invoke the tool create_repo with a natural language command to create or update repositories.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"github mcp server": {
"github": {
"command": "node",
"args": [
"path/to/github-server/build/index.js"
],
"env": {
"GITHUB_TOKEN": ""
}
}
}
}
}McpServers
{
"github": {
"command": "node",
"args": [
"path/to/github-server/build/index.js"
],
"env": {
"GITHUB_TOKEN": ""
}
}
}GitHub MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with GitHub's API. Currently supports creating repositories with descriptions, topics, and website URLs.
Features
- Create GitHub repositories with auto-generated names from descriptions
- Add topics/tags to repositories
- Set repository homepages
- Auto-initialize repositories with README files
Installation
1. Clone the repository
2. Install dependencies:
npm install
3. Build the server:
npm run build
Configuration
The server requires a GitHub personal access token with repository creation permissions. Add the following to your MCP settings file:
{
"mcpServers": {
"github": {
"command": "node",
"args": ["path/to/github-server/build/index.js"],
"env": {
"GITHUB_TOKEN": "your-github-token"
}
}
}
}
Available Tools
create_repo
Create or update GitHub repositories using natural language commands.
Command Format
The tool accepts natural language commands for different operations:
Creating repositories:
Create a repository for [description] with tags [tag1 tag2 tag3] website [url]
or
Make a new repository called [description] tagged with [tag1, tag2, tag3]
Updating repository description:
Update [owner/repo] description to [new description]
or
Change [repo-name] description as [new description]
Updating repository tags:
Update [owner/repo] tags to [tag1 tag2 tag3]
or
Set [repo-name] topics as [tag1, tag2, tag3]
Updating repository website:
Update [owner/repo] website to [url]
or
Set [repo-name] homepage as [url]
Example Usage
Creating a new repository:
const result = await use_mcp_tool({
server_name: "github",
tool_name: "create_repo",
arguments: {
command: "Create a repository for my machine learning image classifier with tags python tensorflow computer-vision website https://example.com/docs"
}
});
This will:
1. Create a repository named "my-machine-learning-image-classifier"
2. Set the description as "my machine learning image classifier"
3. Add "python", "tensorflow", and "computer-vision" as repository topics
4. Set the website to "https://example.com/docs"
5. Initialize with a README file
Updating repository description:
const result = await use_mcp_tool({
server_name: "github",
tool_name: "create_repo",
arguments: {
command: "Update username/existing-repo description to Updated ML project for image classification"
}
});
Updating repository tags:
const result = await use_mcp_tool({
server_name: "github",
tool_name: "create_repo",
arguments: {
command: "Update username/existing-repo tags to machine-learning python updated"
}
});
Updating repository website:
const result = await use_mcp_tool({
server_name: "github",
tool_name: "create_repo",
arguments: {
command: "Update username/existing-repo website to https://example.com/new-docs"
}
});
The tool understands various natural language patterns and keywords:
- Create/make/new for creating repositories
- Update/change/set/modify for updating repositories
- "description to/as" for updating descriptions
- "tags/topics to/as" for updating tags
- "website/homepage/url to/as" for updating websites
Development
To modify or extend the server:
1. Make changes to src/index.ts
2. Rebuild the server:
npm run build
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
