Skip to content

Wellix260/mcp-everything

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mcp-everything

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

PyPI version CI Python 3.10+ License: MIT PRs Welcome


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"
ArXiv 3 ✅ None "Find recent papers on LLM reasoning"
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?"
Pokédex 3 ✅ None "What are Charizard's stats?", "What beats Dragon types?"
Crypto 4 ✅ None "What's Bitcoin's price?", "What crypto is trending today?"
Countries 3 ✅ None "Tell me about Japan", "Compare Germany and France"
Books 4 ✅ None "Find books by Ursula Le Guin", "What's trending on Open Library?"
Recipes 4 ✅ None "Give me a random recipe", "Find pasta recipes"
Dictionary 2 ✅ None "Define 'ephemeral'", "Synonyms for 'happy'"
Translate 2 ✅ None "Translate 'good morning' into Japanese"
Public Holidays 3 ✅ None "What's the next UK public holiday?"
GitHub 5 🔑 Free token "Search GitHub for FastMCP examples"
News 3 🔑 Free tier "Top tech news today", "Search news for AI regulation"
NASA 3 🔑 Free (or DEMO_KEY) "Show me today's Astronomy Picture of the Day", "Any asteroids near Earth?"
Movies & TV 4 🔑 Free (TMDB) "What movies are trending?", "Top rated TV shows of all time"
YouTube 3 🔑 Free (Google) "Search YouTube for Python tutorials", "What's trending in the US?"

13 of 18 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

# Setup & management
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

# Dashboard & config
mcp-everything serve          # open web dashboard at localhost:7337
mcp-everything export         # export your config as a shareable JSON file (keys excluded)
mcp-everything import <file>  # import a config shared by someone else

# Tooling
mcp-everything create <name>  # scaffold a new custom server from a template
mcp-everything test [server]  # fire live API calls and show pass/fail + response times
mcp-everything doctor         # full diagnostics: Python, config, API keys, imports
mcp-everything update         # check PyPI for a newer version

Web Dashboard

mcp-everything serve opens a local web UI at localhost:7337 — no terminal required.

From the dashboard you can:

  • Toggle servers on/off with a single click
  • Enter and save API keys securely (stored in ~/.mcp-everything/.env, not in your Claude config)
  • Run live connection tests against any server
  • See which servers are active at a glance

API Key Storage

API keys are stored in ~/.mcp-everything/.env rather than inside claude_desktop_config.json. This means:

  • More secure — keys live in a dedicated directory with clear ownership
  • Easier to edit — one plain-text file, not buried in a JSON config
  • Shareable configsmcp-everything export produces a key-free JSON anyone can import

The .env file is created automatically the first time you add a key (via setup or the web dashboard).


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, playback control
  • Wolfram Alpha — math, science, data queries
  • Jira / Linear — issue tracking
  • Slack — search messages (via MCP)
  • Single-file installer script (no Python required)

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


Requirements


License

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

About

18 plug-and-play MCP servers for Claude — one install, zero hassle

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages