Lightweight GitHub

You run a lightweight MCP server that wraps a GitHub MCP backend and exposes only a carefully whitelisted set of tools. This minimizes resource use while giving you access to essential GitHub actions through a straightforward, configurable proxy.

How to use

Start by running the MCP server locally, then connect your MCP client so you can browse and execute only the approved tools. The server also provides four built‑in meta-tools to help you discover and filter available upstream tools. Use these to identify what you can enable for your own workflow and to guide users to add needed tools to the whitelist.

How to install

Prerequisites: Node.js and npm installed on your system.

Install dependencies and build the project.

# Install dependencies
npm install

# Build
npm run build

Run the server in normal mode.

npm start

For development, you can watch for changes.

npm run dev

Test the MCP proxy using the inspector tool.

npx @modelcontextprotocol/inspector node dist/index.js

Additional notes and configuration

This server wraps a GitHub MCP backend and uses a YAML configuration to whitelist exposed tools. The configuration file defines which upstream tools are allowed and how to connect to the upstream server.

Available tools

list_all_upstream_tools

Lists all upstream tools, including both allowed and blocked, to help you understand what the proxy can expose.

list_blocked_tools

Shows tools that are currently blocked by the whitelist, categorized for easy review.

search_upstream_tools

Searches upstream tool names by a keyword to help you find relevant capabilities.

get_tool_info

Retrieves detailed information about a specific tool available from the upstream set.