Grep App

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.

- 🔍 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

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

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

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": {} } } }

For HTTP mode, add to your configuration:

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

Therun.shscript provides convenient ways to start the server:

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

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

# 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 Streaming:http://localhost:8603/mcp
- Server-Sent Events:http://localhost:8603/sse

Search for code across public GitHub repositories.

- query(required) - Search query string
- jsonOutput- Return JSON format (default: false)
- numberedOutput- Return numbered list format (default: false)
- caseSensitive- Case-sensitive search
- useRegex- Treat query as regex pattern
- wholeWords- Search whole words only
- repoFilter- Filter by repository name pattern
- pathFilter- Filter by file path pattern
- langFilter- Filter by programming language(s)

{ "query": "async function fetchData", "langFilter": "TypeScript,JavaScript", "numberedOutput": true }

Fetch a single file from a GitHub repository.

- owner(required) - Repository owner
- repo(required) - Repository name
- path(required) - File path
- ref(optional) - Branch/commit/tag reference

{ "owner": "microsoft", "repo": "vscode", "path": "src/vs/editor/editor.api.ts" }

Fetch multiple files from GitHub repositories in parallel.

- files(required) - Array of file objects with owner, repo, path, and optional ref

{ "files": [ {"owner": "facebook", "repo": "react", "path": "packages/react/index.js"}, {"owner": "microsoft", "repo": "TypeScript", "path": "src/compiler/types.ts"} ] }

Retrieve files from previously cached search results.

- query(required) - Original search query
- resultNumbers(optional) - Array of result indices to retrieve

{ "query": "tower_governor", "resultNumbers": [1, 2, 3] }

# Search for React hooks examples searchCode("useEffect cleanup", langFilter: "JavaScript,TypeScript") # Retrieve specific files from results batch_retrieve_files(query: "useEffect cleanup", resultNumbers: [1, 3, 5])

# Find authentication implementations searchCode("JWT authentication middleware", repoFilter: "express") # Get specific implementation details github_file(owner: "auth0", repo: "express-jwt", path: "lib/index.js")

# Discover API patterns searchCode("GraphQL resolver", pathFilter: "/resolvers/") # Compare multiple implementations github_batch_files([ {owner: "apollographql", repo: "apollo-server", path: "packages/apollo-server-core/src/resolvers.ts"}, {owner: "graphql", repo: "graphql-js", path: "src/execution/execute.js"} ])

- npm run build- Build TypeScript to JavaScript
- npm run start- Start production HTTP server
- npm run start-stdio- Start production STDIO server
- npm run dev- Start development HTTP server with hot reload
- npm run dev-stdio- Start development STDIO server with hot reload
- npm run test-client- Run test client

src/ ├── core/ # Core utilities (logger, types) ├── tools/ # MCP tool implementations ├── server.ts # HTTP server entry point └── server-stdio.ts # STDIO server entry point

The server includes comprehensive logging with daily rotation:

- Location:logs/directory
- Rotation: Daily with date-based filenames
- Levels: error, warn, info, debug
- Format: JSON with timestamps
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request

ISC License - see package.json for details

- grep.app- The search service powering this tool
- Model Context Protocol- MCP specification
- Claude Code- Claude's official CLI

A modular MCP server for code analysis, supporting file operations, code search, and structure analysis.