MCP Private GitHub Search

by Hint-Services

397 downloads
Not rated
GitHub

About

MCP Server to search individual private Github Repositories

Details

Author
Hint-Services
Downloads
397
Categories
Search

- Search private GitHub repositories for files and issues.
- Get the contents of a specific file in a repository.
- Type-safe implementation written in TypeScript.
- Robust input validation using Zod schemas.
- Graceful error handling with informative messages.

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Private GitHub Search
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via Smithery or pnpm add mcp-private-github-search, then configure your MCP client with GITHUB_TOKEN, GITHUB_OWNER, and GITHUB_REPO environment variables. The server exposes three tools: searchFiles, searchIssues, and getFileContents, which can be invoked by MCP clients (e.g., Claude, Cursor, Windsurf, Cline).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp private github search": {
            "mcp-private-github-search": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@Hint-Services/mcp-private-github-search",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-private-github-search": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@Hint-Services/mcp-private-github-search",
            "--client",
            "claude"
        ]
    }
}

MCP Private GitHub Search

A Model Context Protocol (MCP) server that provides tools for searching private GitHub repositories. This server enables seamless integration with GitHub's API while handling rate limiting, type safety, and error handling automatically.

Features

- GitHub Repository Search: Search private GitHub repositories (you must have a GitHub token with access to the repository)
- Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
- Input Validation: Robust validation for all API inputs using Zod schemas
- Error Handling: Graceful error handling with informative messages

Core Components

- MCP Servers: These servers act as bridges, exposing APIs, databases, and code libraries to external AI hosts. By implementing an MCP server in TypeScript, developers can share data sources or computational logic in a standardized way using JSON-RPC 2.0.
- MCP Clients: These are the consumer-facing side of MCP, communicating with servers to query data or perform actions. MCP clients use TypeScript SDKs, ensuring type-safe interactions and uniform approach to tool usage.
- MCP Hosts: Systems such as Claude, Cursor, Windsurf, Cline, and other TypeScript-based platforms coordinate requests between servers and clients, ensuring seamless data flow. A single MCP server can thus be accessed by multiple AI hosts without custom integrations.

Available Tools

MCP Private GitHub Search provides the following tools for searching private GitHub repositories :

Search

- searchFiles: Search for files in a repository based on various criteria
- searchIssues: Search for issues in a repository based on various criteria

Get File Information

- getFileContents: Get the contents of a specific file in a repository

Project Structure

mcp-private-github-search/
├── src/
│   ├── index.ts          # Main entry point
│   └── github/           # GitHub API integration
│       ├── client.ts     # GitHub client implementation
│       └── types.ts      # TypeScript type definitions
├── docs/                 # Documentation
├── package.json          # Project configuration
└── tsconfig.json         # TypeScript configuration

Installation

Using Smithery

The easiest way to install MCP Private GitHub Search is using Smithery:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.