Grep.app API를 사용하여 공개 GitHub 저장소의 강력한 코드 검색 기능을 제공하는 모델 Context Protocol (MCP) 서버. 코드 발견을 위해 완벽한, 오픈 소스 프로젝트에서 학습, 구현 예제를 찾는.

♨ 특징

-** 고급 코드 검색**: GitHub에서 수백만 개의 공개 저장소를 검색 -** Re File Retrieval**: GitHub의 특정 파일 또는 일괄 처리 -** - Flexible Filtering**: 언어 필터, 저장소, 파일 경로 등 -** Multiple Multiple Output Formats**: JSON, 번호 목록 또는 형식 텍스트

• ****: 병렬에서 여러 파일을 효율적으로 검색
• ** Result Caching**: 빠른 파일 검색 결과
• ** 포괄적인 로깅**: 매일 회전으로 내장된 로깅

672️ 설치 및 설치

# 필수품

• 노드.js 18+
• npm 또는 원사
• 클로드 코드 CLI

빠른 시작

1. **이 저장소를 다운로드하거나 **

2. **모든 의존성 **

3. **프로젝트 구축 **

4. ** 서버 테스트 **

ܧ Claude 코드에 추가

방법 1: MCP 윤곽 사용하기

이 서버를 Claude Code MCP 구성에 추가하십시오:

메서드 2: HTTP 전송 사용

Grep App MCP Server

A Model Context Protocol (MCP) server that provides powerful code search capabilities across public GitHub repositories using the grep.app API. Perfect for code discovery, learning from open source projects, and finding implementation examples.

🚀 Features

• 🔍 Advanced Code Search: Search across millions of public repositories on GitHub
• 📁 File Retrieval: Fetch specific files or batches of files from GitHub
• 🎯 Flexible Filtering: Filter by language, repository, file path, and more
• 📊 Multiple Output Formats: JSON, numbered lists, or formatted text
• ⚡ Batch Operations: Retrieve multiple files efficiently in parallel
• 🔄 Result Caching: Cache search results for quick file retrieval
• 📝 Comprehensive Logging: Built-in logging with daily rotation

🛠️ Installation & Setup

Prerequisites

• Node.js 18+
• npm or yarn
• Claude Code CLI

Quick Start

1. Clone or download this repository

   git clone https://github.com/ai-tools-all/grep_app_mcp.git
   cd grep_app_mcp
   

2. Install dependencies

   npm install
   

3. Build the project

   npm run build
   

4. Test the server

   # HTTP mode (recommended for development)
   ./run.sh http dev
   
   # or STDIO mode
   ./run.sh stdio dev
   

🔧 Adding to Claude Code

Method 1: Using MCP Configuration

Add this server to your Claude Code MCP configuration:

{
  "mcpServers": {
    "grep_app": {
      "command": "node",
      "args": ["/path/to/grep_app_mcp/dist/server-stdio.js"],
      "env": {}
    }
  }
}

Method 2: Using HTTP Transport

For HTTP mode, add to your configuration:

{
  "mcpServers": {
    "grep_app": {
      "url": "http://localhost:8603/mcp"
    }
  }
}

Then start the server:

./run.sh http prod

📖 run.sh Usage

The run.sh script provides convenient ways to start the server:

Basic Usage

./run.sh [mode] [environment]

Modes

• http - HTTP server with streaming support (default)
• stdio - STDIO server for direct MCP integration

Environments

• dev - Development mode with hot reload (default)
• prod - Production mode (requires build step)

Examples

# Development (default) - HTTP server with hot reload
./run.sh

# Development - HTTP server  
./run.sh http dev

# Production - HTTP server
./run.sh http prod

# Development - STDIO server
./run.sh stdio dev

# Production - STDIO server  
./run.sh stdio prod

# Show help
./run.sh help

HTTP Endpoints (when using HTTP mode)

• HTTP Streaming: http://localhost:8603/mcp
• Server-Sent Events: http://localhost:8603/sse

🔨 Available Tools

1. searchCode

Search for code across public GitHub repositories.

Parameters:

• query (required) - Search query string
• jsonOutput - Return JSON format (default: false)