Merge pull request #103 from 0xRaduan/add-search-for-github

feat(github): Add GitHub Search to Github MCP

Author: jspahrsummers

package-lock.json

@@ -1,13 +1,14 @@
 # GitHub MCP Server
 
-MCP Server for the GitHub API, enabling file operations, repository management, and more.
+MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
 
 ### Features
 
 - **Automatic Branch Creation**: When creating/updating files or pushing changes, branches are automatically created if they don't exist
 - **Comprehensive Error Handling**: Clear error messages for common issues
 - **Git History Preservation**: Operations maintain proper Git history without force pushing
 - **Batch Operations**: Support for both single-file and multi-file operations
+- **Advanced Search**: Support for searching code, issues/PRs, and users
 
 
 ## Tools
@@ -102,6 +103,60 @@ MCP Server for the GitHub API, enabling file operations, repository management,
      - `from_branch` (optional string): Source branch (defaults to repo default)
    - Returns: Created branch reference
 
+10. `search_code`
+    - Search for code across GitHub repositories
+    - Inputs:
+      - `q` (string): Search query using GitHub code search syntax
+      - `sort` (optional string): Sort field ('indexed' only)
+      - `order` (optional string): Sort order ('asc' or 'desc')
+      - `per_page` (optional number): Results per page (max 100)
+      - `page` (optional number): Page number
+    - Returns: Code search results with repository context
+
+11. `search_issues`
+    - Search for issues and pull requests
+    - Inputs:
+      - `q` (string): Search query using GitHub issues search syntax
+      - `sort` (optional string): Sort field (comments, reactions, created, etc.)
+      - `order` (optional string): Sort order ('asc' or 'desc')
+      - `per_page` (optional number): Results per page (max 100)
+      - `page` (optional number): Page number
+    - Returns: Issue and pull request search results
+
+12. `search_users`
+    - Search for GitHub users
+    - Inputs:
+      - `q` (string): Search query using GitHub users search syntax
+      - `sort` (optional string): Sort field (followers, repositories, joined)
+      - `order` (optional string): Sort order ('asc' or 'desc')
+      - `per_page` (optional number): Results per page (max 100)
+      - `page` (optional number): Page number
+    - Returns: User search results
+
+## Search Query Syntax
+
+### Code Search
+- `language:javascript`: Search by programming language
+- `repo:owner/name`: Search in specific repository
+- `path:app/src`: Search in specific path
+- `extension:js`: Search by file extension
+- Example: `q: "import express" language:typescript path:src/`
+
+### Issues Search
+- `is:issue` or `is:pr`: Filter by type
+- `is:open` or `is:closed`: Filter by state
+- `label:bug`: Search by label
+- `author:username`: Search by author
+- Example: `q: "memory leak" is:issue is:open label:bug`
+
+### Users Search
+- `type:user` or `type:org`: Filter by account type
+- `followers:>1000`: Filter by followers
+- `location:London`: Search by location
+- Example: `q: "fullstack developer" location:London followers:>100`
+
+For detailed search syntax, see [GitHub's searching documentation](https://docs.github.com/en/search-github/searching-on-github).
+
 ## Setup
 
 ### Personal Access Token