MCP Servers Monorepo

This repository is a monorepo for Model Context Protocol (MCP) servers, using pnpm workspaces. It currently contains the GitHub MCP Server, which provides tools to interact with GitHub using an AI agent.

Setup

1. Install Dependencies Run the following command at the root of the repository to install all required dependencies:

   pnpm install

2. Configure Environment Variables The GitHub MCP server requires a Personal Access Token (PAT) to interact with the GitHub API.

   Navigate to the GitHub app directory and create your .env file:

   cd apps/github-mcp
   cp .env.example .env

   Open the .env file and replace your_personal_access_token_here with your actual GitHub PAT. You can generate one from your GitHub Developer Settings. Make sure it has repo access.

Related MCP server: GitHub Integration Hub

Configuring with Antigravity IDE

To use this MCP server within the Antigravity IDE, you need to add it to your global MCP configuration file.

1. Open the file ~/.gemini/config/mcp_config.json (or /home/<your-user>/.gemini/config/mcp_config.json).

2. Add the github-mcp configuration inside the mcpServers block:

{
    "mcpServers": {
        "github-mcp": {
            "command": "npx",
            "args": [
                "tsx",
                "/mnt/UbuntuDataDisk/nilesh/Project/mcp-servers/apps/github-mcp/src/index.ts"
            ],
            "env": {
                "GITHUB_TOKEN": "<your_personal_access_token_here>"
            }
        },
        "mongodb-mcp": {
            "command": "npx",
            "args": [
                "tsx",
                "/mnt/UbuntuDataDisk/nilesh/Project/mcp-servers/apps/mongodb-mcp/src/index.ts"
            ],
            "env": {
                "MONGODB_URI": "mongodb://localhost:27017",
                "MONGODB_ALLOW_MUTATIONS": "false"
            }
        }
    }
}

3. Save the file and reload the IDE window for the tools to become available.

Running the Server

You can run the server directly (it will run on stdio and wait for JSON-RPC messages):

pnpm run dev

(Note: Running this command directly won't give you interactive feedback, as it's designed to be consumed by an AI client.)

Debugging and Testing (MCP Inspector)

To test the MCP tools interactively, you can use the official MCP Inspector. We have set up a convenient script that runs the inspector without polluting the standard output with pnpm logs.

From the root of the repository, run:

pnpm run inspector

How to use the Inspector:

1. The command will output a local URL (e.g., http://localhost:5173).

2. Open that URL in your browser.

3. Click the Connect button in the top right corner.

4. You will see a list of tools (like listRepositories, getRepository, etc.).

5. Click on a tool, enter the arguments (e.g., nilesh-singh-me for the owner field), and click Run Tool to see the live data fetched from GitHub!

Available Tools

The server currently provides the following tools:

• listRepositories: List repositories for a GitHub user or organization.

• getRepository: Get details of a specific GitHub repository.

• listPullRequests: List pull requests for a specific GitHub repository.

• createIssue: Create a new issue in a GitHub repository.

• getFile: Get the contents of a specific file in a GitHub repository.

• getPullRequest: Fetch details of a specific pull request (description, mergeability, status).

• createPullRequest: Open a new pull request automatically.

• listPullRequestFiles: See which files were modified in a pull request.

• createPullRequestReview: Leave code review comments on specific lines or approve PRs.

• mergePullRequest: Automatically merge a pull request.

• searchCode: Search for specific functions or variables across the entire repository.

• createOrUpdateFile: Commit small fixes or create new files directly via the GitHub API.

• deleteFile: Delete a file directly via the GitHub API.

• listBranches: See all available branches in a repository.

• createBranch: Create a new branch (e.g., fix/typo-in-readme) to isolate work.

• listCommits: Fetch the commit history of a branch to understand recent changes.

Project Structure

• apps/github-mcp/: The GitHub MCP server implementation.

  • src/tools/: Contains individual files for each tool (schemas and handlers).

  • src/index.ts: The main entrypoint that registers the tools and starts the server.

  • src/config.ts: Configuration loader (handles .env).

  • src/github.ts: The Octokit GitHub client setup.