Grep.app API を使用して、公開 GitHub リポジトリ間で強力なコード検索機能を提供するモデルコンテキストプロトコル (MCP) サーバー。 コードディスカバリー、オープンソースプロジェクトから学び、導入事例を探し出せる

OST の特徴

-** 上級コード検索**: GitHubで何百万人ものパブリックリポジトリを横断検索

• 📁 ファイル検索: GitHubから特定のファイルやファイルのバッチを取得する
• 柔軟なフィルタリング:言語、リポジトリ、ファイルパスなどのフィルタ -複数の出力形式:JSON、番号付きリスト、またはフォーマットされたテキスト
• ** ⚡ バッチ操作**: 並列で複数のファイルを効率的に取得する -** 結果のキャッシュ**: キャッシュの検索結果の迅速なファイル検索結果
• ** 包括的なロギング**:毎日の回転でロギング内蔵

️️ インストールとセットアップ

前提条件

• Node.js 18 +
• npmかヤーン
• クロード コード クリップ

クイックスタート

1.このリポジトリのクローンまたはダウンロード

2.依存関係のインストール

3。プロジェクトを構築する

4。 サーバーをテストして下さい

☑ ロードコードに追加

メソッド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)