mcp-github
Allows searching and reading GitHub repositories, issues, pull requests, commits, and file contents via read-only tools, scoped to the user's personal access token.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-githubsearch for repositories about MCP servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-github
GitHub MCP server for Lume — the first non-built-in plugin in the Lume marketplace, used to validate the third-party plugin flow end to end.
Read-only in v1. Lets the assistant search and read GitHub repos, issues, pull requests, commits, and file contents on the user's behalf, scoped to whatever the user's personal access token can see.
Tools (read-only v1)
Tool | Purpose |
| Search repos using GitHub query syntax |
| Search issues across visible repos |
| Search code across visible repos |
| List issues in a specific repo |
| Read full body and metadata of one issue |
| List PRs in a specific repo |
| Read PR body, branches, diff stats |
| List recent commits in a repo |
| Read a file at a path/ref |
Related MCP server: GitHub Read MCP Server
Authentication
Per-user model: the api process injects a JSON X-PA-Credentials header on each call; this server reads github_token from it. Falls back to the GITHUB_TOKEN env var only when no header is present (bootstrap admin).
To configure as a Lume user:
Create a personal access token at https://github.com/settings/tokens. Fine-grained or classic; read-only scopes are sufficient (
repo:read,read:org, etc.).In Lume → Settings → Plugins → GitHub, paste the token. The server retrieves it on every tool call via the encrypted credential vault.
Running
The plugin is intended to run as a sidecar to the PA-iOS docker-compose stack. To install:
Clone this repo next to your PA-iOS clone:
git clone https://github.com/bryarpatch36/mcp-github.gitMerge the
compose.fragment.ymlsnippet into yourPA-iOS/docker-compose.yml.docker compose up -d --build mcp-github.Install the plugin in Lume from Settings → Plugins → Discover.
Manifest
The Lume plugin manifest lives at manifest.json and is fetched by Lume's marketplace catalog from https://raw.githubusercontent.com/bryarpatch36/mcp-github/main/manifest.json.
Roadmap
v1.0 — read-only (this release)
v1.1 — issue and PR comments behind Lume's two-phase confirmation protocol
v1.2 — issue and PR creation behind confirmation
Forks, branches, merges remain explicitly out of scope; those should run from a real shell, not an LLM tool call.
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Read-only MCP server: let AI agents read your ORANO saved-video library, tasks, and memory.
Search GitHub, npm, PyPI, StackOverflow, ArXiv from one MCP — built for coding agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP (Model Context Protocol) server for GitHub API integration. This server provides comprehensive tools for interacting with GitHub repositories, issues, pull requests, branches, and code search through a unified interface.152 npmMIT
- FlicenseNot gradedqualityFmaintenanceRead-only MCP server for the GitHub REST API that enables agents to query repositories, issues, files, and users without any write access.-
- FlicenseNot gradedqualityDmaintenanceA read-only MCP server that exposes GitHub user profiles, repository info, and search via tools for AI assistants like Claude.-
- FlicenseAqualityCmaintenanceMCP server that wraps GitHub REST API to allow AI agents to search repositories, get repository details, list issues, and read READMEs.4-