Search MCP Server
Provides tools to search GitHub repositories, issues, pull requests, and code, and to fetch raw file contents from public GitHub repositories.
Provides web search via the Google Custom Search JSON API, allowing AI agents to search the web and optionally restrict results to a specific site.
Provides tools to search Reddit posts across all of Reddit or within a specific subreddit, and to retrieve full post bodies with top-voted comments.
Provides tools to search Stack Overflow questions and retrieve full question bodies with accepted or top-voted answers.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Search MCP Server (search-mcp)
A lightweight Python Model Context Protocol (MCP) server that gives AI agents direct search access to Google, Stack Overflow, GitHub, and Reddit—offloading web and code lookups from local compute.
Features & API Key Requirements
Platform | Tool(s) | Key Required? | Free Tier & Details |
Stack Overflow |
| No (Optional) | 300 requests/day without a key. Add |
GitHub |
| No for repos, issues & files (Optional for code search) | 10 search requests/min without a key. Add |
| No (Optional) | Works without a key via Reddit's public JSON endpoints. Add | |
| Yes | 100 queries/day free via Official Google Custom Search JSON API ( |
Related MCP server: jiro
Quick Start
1. Create a Virtual Environment & Install Dependencies
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt2. Configure .env (Optional for Stack Overflow & GitHub, Required for Google)
Copy the template .env.example to .env:
cp .env.example .envEdit .env to add any keys you want to use (.env is gitignored):
GOOGLE_API_KEY&GOOGLE_CSE_ID:Get an API key from the Google Custom Search JSON API page.
Create a search engine at Programmable Search Engine (enable "Search the entire web") and copy its Search engine ID (
cx).
GITHUB_TOKEN(optional): Create a GitHub Personal Access Token (no scopes needed for public search) to unlock code search and higher rate limits.STACKEXCHANGE_KEY(optional): Register on Stack Apps to raise the daily quota from 300 to 10,000 requests.REDDIT_CLIENT_ID&REDDIT_CLIENT_SECRET(optional): Create an app at Reddit App Preferences to use OAuth2 (oauth.reddit.com) instead of unauthenticated public JSON endpoints.
3. Add to Your MCP Client Configuration
Add the server to your MCP client config (e.g., Claude Desktop, Cursor, or Antigravity mcp_config.json):
{
"mcpServers": {
"search-mcp": {
"command": "/Users/null/Desktop/search-mcp/.venv/bin/python",
"args": ["/Users/null/Desktop/search-mcp/server.py"]
}
}
}Available Tools
search_google(query, num_results=5, site_search=None)— Search the web via Google Custom Search JSON API.search_stackoverflow(query, tagged=None, sort="relevance", num_results=5, include_top_answers=True)— Search Stack Overflow questions and automatically include accepted/top-voted answers.get_stackoverflow_question(question_id, max_answers=3)— Retrieve full question body and top answers by Stack Overflow question ID.search_github(query, search_type="repositories", sort=None, num_results=5)— Search GitHubrepositories,issues(including PRs), orcode.get_github_file(repo, path, ref=None)— Fetch raw file contents (such as aREADME.mdor source file) from any public GitHub repository.search_reddit(query, subreddit=None, sort="relevance", time_filter="all", num_results=5)— Search Reddit posts across all of Reddit or within a specific subreddit.get_reddit_post(post_id_or_url, max_comments=5)— Fetch the full body and top-voted comments of a Reddit post by ID or URL.
License
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Free web search for AI agents. No API key required. Hosted MCP in active development.
A hosted MCP suite providing workflow primitives: web search, content fetching, compression, deduplication, cost/budget management, and agent memory pipelines.
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.4Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform live web searches across 9 engines, scrape web pages into clean formats, and run agentic research with citations via MCP.60 PyPI7MIT
- AlicenseBqualityBmaintenanceEnables AI agents to perform web searches and extract full-text content from web pages via standard MCP tools, with fallback search and semantic reranking.22MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform local-first web search, fetch, crawl, extract, cache, research, and autonomous information gathering through MCP, with no API keys or cloud dependencies.841 npmAGPL 3.0