mcp-everything 0.1.0

10+ plug-and-play MCP servers for Claude — Hacker News, Wikipedia, Weather, GitHub, Reddit, and more. One install, zero hassle.

mcp-everything

10+ plug-and-play MCP servers for Claude — one install, zero hassle.

---

mcp-everything is a single Python package that ships real, working MCP servers — not just a list of links. Install once, run the setup wizard, restart Claude Desktop, and you're done.

pip install mcp-everything
mcp-everything setup

That's it. Claude can now browse Hacker News, search Wikipedia, look up weather, pull GitHub issues, search Reddit, fetch research papers, and more — all without leaving the conversation.

---

Servers

Server	Tools	API Key?	What you can ask Claude
Hacker News	4	✅ None	"What's trending on HN today?", "Search HN for posts about Rust"
Wikipedia	4	✅ None	"Summarise the Wikipedia article on black holes", "What happened on this day in history?"
ArXiv	3	✅ None	"Find recent papers on LLM reasoning", "Get the abstract for arxiv 2305.10403"
Weather	2	✅ None	"What's the weather in Tokyo?", "7-day forecast for London"
Reddit	4	✅ None	"What are the hot posts on r/MachineLearning?", "Search Reddit for Claude MCP"
Pokédex	3	✅ None	"What are Charizard's stats?", "What's super-effective against Dragon types?"
GitHub	5	🔑 Free token	"Search GitHub for FastMCP examples", "List open issues in anthropics/anthropic-sdk-python"
News	3	🔑 Free tier	"Top tech news today", "Search news for AI regulation"

6 of 8 servers work with zero API keys. mcp-everything setup will only ask for keys when you actually enable a server that needs one.

---

Quick Start

1. Install

pip install mcp-everything

2. Run the setup wizard

mcp-everything setup

The wizard will:

• Show you all available servers in a nice table
• Let you pick which ones to enable (all, free, or 1,2,5)
• Prompt for API keys only for servers you enable that need them
• Auto-detect your Claude Desktop config path (macOS / Windows / Linux)
• Write the config and tell you to restart Claude

3. Restart Claude Desktop

That's it. You'll see your new MCP servers connected in Claude.

---

Manual Install (without the wizard)

If you'd rather configure manually, add servers to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hackernews": {
      "command": "python",
      "args": ["-m", "mcp_everything.servers.hackernews"]
    },
    "wikipedia": {
      "command": "python",
      "args": ["-m", "mcp_everything.servers.wikipedia"]
    },
    "weather": {
      "command": "python",
      "args": ["-m", "mcp_everything.servers.weather"]
    },
    "github": {
      "command": "python",
      "args": ["-m", "mcp_everything.servers.github"],
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      }
    }
  }
}

---

CLI Reference

mcp-everything setup          # interactive setup wizard
mcp-everything list           # show all available servers
mcp-everything add <server>   # add a single server (e.g. mcp-everything add hackernews)
mcp-everything remove <server># remove a server
mcp-everything status         # show which servers are currently active

---

Server Details

Hacker News

No API key needed. Uses the official HN Firebase API + Algolia search.

Tool	Description
hn_top_stories	Get current top stories (up to 30)
hn_search	Full-text search via Algolia
hn_get_comments	Get top comments for any story ID
hn_ask_hn	Get current "Ask HN" posts

Wikipedia

No API key needed. Uses the Wikipedia REST API.

Tool	Description
wikipedia_search	Search for articles
wikipedia_summary	Get concise article summary
wikipedia_random	Get a random article
wikipedia_on_this_day	Historical events for any date

ArXiv

No API key needed. Uses the ArXiv public API.

Tool	Description
arxiv_search	Search papers by keyword + optional category
arxiv_recent	Latest papers in a category (e.g. cs.AI)
arxiv_get_paper	Full metadata for a paper ID or URL

Weather

No API key needed. Uses Open-Meteo — free, no registration, no rate limits.

Tool	Description
weather_current	Current conditions for any city
weather_forecast	1–14 day forecast

Reddit

No API key needed. Uses Reddit's public JSON endpoints.

Tool	Description
reddit_hot	Hot posts in any subreddit
reddit_search	Search across Reddit
reddit_top	Top posts by time period
reddit_comments	Read top comments from a post

Pokédex

No API key needed. Uses PokéAPI.

Tool	Description
pokedex_get	Pokémon stats by name or number
pokedex_move	Move details (power, accuracy, PP)
pokedex_type_matchup	Type effectiveness chart

GitHub

Free API token from github.com/settings/tokens. Read-only public access is enough. Without a token, GitHub allows 60 unauthenticated requests/hour (still works for light use).

Tool	Description
github_search_repos	Search repositories by keyword
github_get_repo	Full repo metadata
github_list_issues	Open/closed issues for any repo
github_search_code	Search code across GitHub
github_trending	Top-starred repos, optionally by language

News (NewsAPI)

Free API key from newsapi.org/register. Free tier: 100 requests/day, developer use only.

Tool	Description
news_headlines	Top headlines by country + category
news_search	Search news articles
news_sources	List available news sources

---

Adding a New Server (Contributing)

Each server is a self-contained Python file using FastMCP:

# mcp_everything/servers/myserver.py
from mcp.server.fastmcp import FastMCP
import httpx

mcp = FastMCP("myserver")

@mcp.tool()
async def my_tool(query: str) -> str:
    """Description Claude will see. Args are auto-documented.

    Args:
        query: What to search for
    """
    # your implementation
    return "result"

if __name__ == "__main__":
    mcp.run()

Then add an entry to the SERVERS list in mcp_everything/config.py and open a PR. That's genuinely all it takes — we'd love more servers!

See CONTRIBUTING.md for full guidelines.

---

Roadmap

• Spotify — now playing, search, control playback
• YouTube — search videos, fetch transcripts
• Wolfram Alpha — math, science, data queries
• Jira / Linear — issue tracking
• Slack — search messages (via MCP)
• Single-file installer script (no Python required)
• Auto-update via mcp-everything update

Have a server you'd love to see? Open an issue.

---

Requirements

• Python 3.10+
• Claude Desktop (macOS, Windows, or Linux)

---

License

MIT — do whatever you want with it. A ⭐ star is always appreciated.