Mcp Github Advanced Search

MCP搜索检索

提供方 louiscklaw

搜索检索 未标注 会话登录 社区 / 第三方 ClaudeCursorCodexZed

this is a simple mcp server that helps user perform search in github

一句话选型结论

按资料字段整理

Mcp Github Advanced Search 属于搜索检索类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude、Cursor、Codex 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

github git coding

支持客户端

适用场景

githubgitcoding

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude、Cursor、Codex,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mcp Github Advanced Search当前 未标注 未标注 未标注 无 未标注
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方louiscklaw上游标注的维护方 louiscklaw
分类搜索检索本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

11.8 KB
来自项目仓库与上游目录的原文,未做删改

MCP Server for GitHub Advanced Search (G.A.S.)

A powerful Model Context Protocol (MCP) server that enables Large Language Models to perform advanced GitHub code searches with intelligent filtering and content retrieval capabilities, optimized for DeepSeek integration.

🔍 Overview

The GitHub Advanced Search (G.A.S.) MCP server provides LLMs with sophisticated GitHub search capabilities that go beyond standard API limitations. Using web automation with Playwright, it enables deep code discovery, pattern analysis, and content retrieval across the entire GitHub ecosystem. This version includes enhanced support for DeepSeek models, providing tailored search results and structured JSON output.

Demo

> tested using vscode + cline + openrouter:deepseek/deepseek-r1-0528:free

youtube link to demo

Example1```prompt

step1: init gas

gas_entrypoint

step2: feed model

gas_search_code
file_name: clinerules

step3: make your wish

You are now have better knowledge of clinerules
please keep the current file format and deep level
enhance the <file-path-to-clinerules>


### Key Features

- 🔍 **Advanced GitHub Search**: Search by keywords, file names, and complex filters
- 📁 **Content Retrieval**: Automatically fetch and return file contents
- 🤖 **LLM Integration**: Seamless integration with Claude, GPT, and other MCP-compatible LLMs
- 🔄 **Pagination Support**: Handle large result sets with intelligent pagination
- 🌐 **Web Automation**: Uses Playwright for robust GitHub interaction
- 📊 **Structured Results**: Returns organized JSON data with repository links, file links, and content
- ⚡ **High Performance**: Async operations with concurrent file downloads
- 🔐 **Authentication Support**: Works with GitHub login for private repositories
- 🤖 **DeepSeek Integration**: Optimized for use with DeepSeek models, providing tailored search results and structured JSON output

## 🏗️ Architecture```mermaid
graph TB
    subgraph "MCP Client (LLM)"
        A[Claude/GPT/Other LLM]
    end

    subgraph "MCP Server (G.A.S.)"
        B[MCP Server]
        C[Search Engine]
        D[Playwright Browser]
        E[Content Fetcher]
        F[Result Processor]
    end

    subgraph "GitHub"
        G[GitHub Search]
        H[Repository Files]
        I[Raw Content]
    end

    A -->|MCP Protocol| B
    B --> C
    C --> D
    D -->|Web Automation| G
    G -->|Search Results| D
    D --> E
    E -->|HTTP Requests| I
    I -->|File Content| E
    E --> F
    F -->|Structured Data| B
    B -->|JSON Response| A

    classDef client fill:#e1f5fe,stroke:#01579b,color:#01579b
    classDef server fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
    classDef github fill:#f3e5f5,stroke:#4a148c,color:#4a148c

    class A client
    class B,C,D,E,F server
    class G,H,I github

🔄 Search Workflow```mermaid

sequenceDiagram
participant LLM as LLM Client
participant MCP as MCP Server
participant PW as Playwright Browser
participant GH as GitHub Search
participant API as GitHub Raw API

LLM->>MCP: gas_search_code(keyword, file_name)
MCP->>PW: Launch browser session
PW->>GH: Navigate to search URL
GH-->>PW: Search results page
PW->>PW: Extract repository & file links

loop For each page
    PW->>GH: Navigate to page N
    GH-->>PW: Results for page N
    PW->>PW: Extract links from page
end

MCP->>API: Fetch file contents (async)
API-->>MCP: Raw file content
MCP->>MCP: Structure response data
MCP-->>LLM: JSON with repositories, files & content

alt More results available
    LLM->>MCP: get_remaining_result(start_id)
    MCP-->>LLM: Next batch of results
end

## 🚀 Quick Start

### Prerequisites

- Python 3.10 or higher
- Node.js (for Playwright browser automation)
- GitHub account (recommended for optimal functionality)

### Installation

1. **Install the package:**```bash
   pip install mcp-server-git-gas
   ```

2. **Install Playwright browsers:**```bash
   playwright install chromium
   ```

3. **💀Not tested** **Configure your MCP client** (e.g. claude desktop):

   Add to your `claude_desktop_config.json`:```json
   # not tested !!!
   {
     "mcpServers": {
       "github-advanced-search": {
         "command": "mcp-server-git-gas",
         "args": []
       }
     }
   }
   ```

### First Search

Once configured, you can start searching GitHub through your LLM:```
Search GitHub for Python files containing "async def" functions

The LLM will automatically use the G.A.S. tools to perform the search and return structured results.

📦 Installation Options from Source

step1 (clone source)```bash

$ cd ~
$ git clone --depth=1 https://github.com/louiscklaw/mcp-github-advanced-search ~/mcp/mcp-git-gas


### step2 (install remaining dependencies, playwright)```bash
# Install Playwright browsers
$ playwright install chrome
$ playwright install --deps

step3 seed chrome user credentials```bash

this will create the user_data_dir for chromium

go login google or any other service you want

$ cd ~/mcp/mcp-git-gas
$ ./seedChromeUserDataDir.sh


## ⚙️ Configuration

### VS Code with MCP Extension```json
{
  "mcp": {
    "servers": {
      "git-gas": {
        "autoApprove": [
          "get_remaining_result",
          "gas_readme",
          "gas_search_code"
        ],
        "disabled": false,
        "timeout": 300,
        "type": "stdio",
        "command": "uv",
        "args": [
          "--directory",
          "<USER_HOME_DIR>/mcp/mcp-git-gas/src/mcp_server_git_gas",
          "run",
          "mcp-server-git-gas"
        ]
      }
    }
  }
}

🛠️ Available Tools

gas_entrypoint

Initialize and get information about the GitHub Advanced Search server.

Parameters: None

Returns: Server information and usage instructions with workflow diagram.```mermaid
graph TD
a((start))
d((end))
b("search code with filter (gas_search_code)")
c("return search result")
c1("is the result finished ?")
c2("use get_remaining_result to list remaining result")
a --> b --> c --> c1 -- Yes --> d
c1 -- No --> c2
c2 --> c1


### `gas_search_code`

Search GitHub repositories with advanced filters.

**Parameters:**

- `keyword` (string, optional): Search keyword (single word recommended)
- `file_name` (string, optional): Specific filename to search for (e.g., ".clinerules", "README.md")

**Returns:** Array of search results with:```json
[
  {
    "REPOSITORY_LINK": "https://github.com/owner/repo",
    "FILE_LINK": "https://github.com/owner/repo/blob/main/file.py",
    "RAW_UESR_CONTENT_LINK": "https://raw.githubusercontent.com/owner/repo/main/file.py",
    "FILE_CONTENT": "actual file content..."
  }
]

get_remaining_result

Retrieve additional results from a previous search (pagination).

Parameters:

  • start_id (integer): Starting index for the next batch of results

Returns: Next batch of search results with the same structure as gas_search_code.

💡 Usage Examples

step1```

call gas_entrypoint to initialize yourself


### step2```
Hi,

please use `gas_search_code` with below json

{
  "keyword": "mcp mermaid",
  "file_name": "README.md"
}

and understand the content returned, i will send you the task afterwards.

step3```

i am working on a python project,
please task a look to the source code of the project.

with the help from files in former results.
please help to and update the README file.


## 🔧 Configuration & Environment

### Browser Configuration

The server uses Playwright with persistent browser context for:

- Session management
- Authentication state preservation
- Improved performance

Browser data is stored in: `~/mcp/mcp-git-gas/_user_data_dir`

## 🏃‍♂️ Development

### Local Development Setup```bash
# Clone the repository
git clone <repository-url>
cd mcp-server-git-gas

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts/activate

# Install dependencies
pip install -e .

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

Project Structure```bash

src/mcp_server_git_gas/
├── init.py # CLI entry point
├── server.py # Main MCP server implementation
├── CONST.py # Configuration constants
├── fetch_data.py # Async HTTP client
├── fetchFileContent.py # File content retrieval
├── convertFileLinkToRaw... # URL conversion utilities
├── url_util.py # URL building helpers
└── git_dump_screen.py # Debug utilities


### Key Components

- **MCP Server**: Implements the Model Context Protocol interface
- **Search Engine**: Handles GitHub search logic and pagination
- **Content Fetcher**: Retrieves file contents asynchronously
- **Browser Automation**: Playwright-based GitHub interaction

### Testing with MCP Inspector```bash
# Test the server with MCP inspector
npx @modelcontextprotocol/inspector uvx mcp-server-git-gas

Docker Development```bash

Build development image

docker build -t mcp/git-gas:dev .

Run with volume mount for development

docker run --rm -i \
-v $(pwd):/app \
mcp/git-gas:dev
```

🔍 How It Works

  1. Search Initiation: LLM calls gas_search_code with search parameters
  2. Query Building: Server constructs GitHub search URL with filters
  3. Web Automation: Playwright navigates GitHub search pages
  4. Result Extraction: JavaScript execution extracts repository and file links
  5. Content Retrieval: Parallel HTTP requests fetch file contents
  6. Response Formatting: Results structured as JSON for LLM consumption

🐛 Troubleshooting

Common Issues

  1. "Not logged in" errors
  • Solution: run seedChromeUserDataDir.sh to start a browser and perform login
  1. No results found
  • Check search keywords for typos
  • Try broader search criteria
  • Verify GitHub is accessible
  1. Browser launch failures
  • Run: playwright install chromium
  • Check system requirements for Playwright
  1. Rate limiting
    - GitHub may rate limit requests
    - The server includes delays and retry logic
    - Consider using authenticated sessions for higher limits

Debug Mode

Debug screenshots are saved to: ~/mcp_github_advanced_search/debug.png

📊 Performance

  • Search Speed: ~2-5 seconds per search page
  • Concurrent Requests: Up to 10 parallel file downloads
  • Result Limits: 20 results per search (configurable)
  • Pagination: Supports up to 2 pages (100+ results)

🚨 Important Notes

  • GitHub Authentication: Login to GitHub in the browser for optimal results
  • Rate Limiting: Respects GitHub's usage policies
  • Browser Requirements: Requires Chromium browser (installed via Playwright)
  • Network Dependencies: Requires internet connection for GitHub access

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Add tests for new functionality
  5. Run the test suite
  6. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built on the Model Context Protocol by Anthropic
  • Uses Playwright for browser automation
  • Inspired by the need for advanced GitHub search capabilities in LLM workflows
  • Thanks to the MCP community for feedback and contributions

🔗 Related Projects

  • Model Context Protocol
  • Anthropic MCP Servers
  • Playwright
  • MCP Mermaid Image Gen
  • MCP Governance SDK

📞 Support

  • Issues: GitHub Issues
  • Discussions: GitHub Discussions
  • Documentation: Wiki

Note: This server requires a GitHub account for optimal functionality. Some features may be limited when used without authentication.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Mcp Github Advanced Search 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Mcp Github Advanced Search 怎么在 Claude、Cursor、Codex 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mcp Github Advanced Search 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mcp Github Advanced Search 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Mcp Github Advanced Search 支持哪些客户端?

资料标注支持 Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mcp Github Advanced Search 能提供哪些能力?

资料显示能力标签包括 github、git、coding。具体工具清单以官方文档为准。

Mcp Github Advanced Search 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。