Labsco
ajaychinthapalli logo

GitHub Pages MCP Server

from ajaychinthapalli

Hello! This is a GitHub MCP server designed to enable MCP-compatible LLMs, such as Claude, to communicate with the server and interact with the GitHub API to manage GitHub Pages deployments.

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#automation#devops#git

GitHub Pages MCP Server

A Model Context Protocol (MCP) server for managing GitHub Pages deployments. This server provides tools to enable, configure, deploy, and manage GitHub Pages sites through the MCP protocol.

Features

This MCP server provides the following tools:

  • enable_github_pages - Enable GitHub Pages for a repository with custom source and build settings
  • get_github_pages_info - Get current GitHub Pages configuration and deployment status
  • deploy_to_github_pages - Deploy files directly to GitHub Pages branch
  • disable_github_pages - Disable GitHub Pages for a repository
  • update_github_pages_config - Update GitHub Pages configuration (source, build type, custom domain)

Tools Reference

enable_github_pages

Enable GitHub Pages for a repository.

Parameters:

  • owner (string, required): Repository owner (username or organization)
  • repo (string, required): Repository name
  • source (object, required):
    • branch (string, required): Branch to deploy from (e.g., 'main', 'gh-pages')
    • path (string, optional): Path to deploy from ('/' or '/docs')
  • build_type (string, optional): Build type - 'legacy' for Jekyll or 'workflow' for GitHub Actions

Example:

Copy & paste — that's it
{
  "owner": "username",
  "repo": "my-website",
  "source": {
    "branch": "main",
    "path": "/docs"
  },
  "build_type": "legacy"
}

get_github_pages_info

Get the current GitHub Pages configuration and status.

Parameters:

  • owner (string, required): Repository owner
  • repo (string, required): Repository name

Example:

Copy & paste — that's it
{
  "owner": "username",
  "repo": "my-website"
}

deploy_to_github_pages

Deploy files to a GitHub Pages branch by creating commits.

Parameters:

  • owner (string, required): Repository owner
  • repo (string, required): Repository name
  • branch (string, required): Branch to deploy to (must match GitHub Pages source branch)
  • message (string, optional): Commit message
  • files (array, optional): Array of files to deploy
    • path (string, required): File path in repository
    • content (string, required): File content
    • encoding (string, optional): 'utf-8' or 'base64'

Example:

Copy & paste — that's it
{
  "owner": "username",
  "repo": "my-website",
  "branch": "gh-pages",
  "message": "Update homepage",
  "files": [
    {
      "path": "index.html",
      "content": "<html><body>Hello World</body></html>",
      "encoding": "utf-8"
    }
  ]
}

disable_github_pages

Disable GitHub Pages for a repository.

Parameters:

  • owner (string, required): Repository owner
  • repo (string, required): Repository name

Example:

Copy & paste — that's it
{
  "owner": "username",
  "repo": "my-website"
}

update_github_pages_config

Update GitHub Pages configuration settings.

Parameters:

  • owner (string, required): Repository owner
  • repo (string, required): Repository name
  • source (object, optional):
    • branch (string, required): Branch to deploy from
    • path (string, optional): Path to deploy from
  • build_type (string, optional): 'legacy' or 'workflow'
  • cname (string, optional): Custom domain name

Example:

Copy & paste — that's it
{
  "owner": "username",
  "repo": "my-website",
  "source": {
    "branch": "main",
    "path": "/"
  },
  "cname": "www.example.com"
}

Development

Building

Copy & paste — that's it
npm run build

Watching for Changes

Copy & paste — that's it
npm run watch

Linting

Copy & paste — that's it
npm run lint

Releasing

This project uses GitHub Actions to automatically create releases when version tags are pushed.

Creating a Release

  1. Update the version in package.json
  2. Commit the changes
  3. Create and push a version tag:
Copy & paste — that's it
git tag v1.0.0
git push origin v1.0.0

The GitHub Actions workflow will automatically:

  • Build the project
  • Create a GitHub release with the tag
  • Upload release assets:
    • github-pages-mcp-server-dist.tar.gz - Compiled distribution files
    • github-pages-mcp-server-full.tar.gz - Full source code (excluding node_modules)
  • Generate release notes automatically

License

MIT