Everything MCP Server (Remote, deployable to Render.com)

A small personal remote MCP server with four demo tools:

• echo — repeats text back
• add — adds two numbers
• currentTime — returns current UTC time
• randomFact — returns a random fun fact

It uses Streamable HTTP transport (not stdio), which is what remote/hosted MCP servers need — this is different from your local WeatherMCPServer, which uses stdio and only runs as a subprocess on your own machine.

1. Test locally first (optional but recommended)

npm install
npm start

Server starts on http://localhost:3000/mcp. Test it with MCP Inspector:

npx @modelcontextprotocol/inspector

Open the Inspector UI (usually http://localhost:6274), choose Streamable HTTP as the transport type, and set the URL to http://localhost:3000/mcp. Click Connect, then List Tools to see all four tools and try calling one.

2. Push this project to GitHub

git init
git add .
git commit -m "Initial commit: everything-mcp-server"

Create a new repository on GitHub (via the website), then:

git remote add origin https://github.com/<your-username>/everything-mcp-server.git
git branch -M main
git push -u origin main

3. Deploy to Render.com

1. Go to https://dashboard.render.com and sign in (or create a free account).
2. Click New → Web Service.
3. Connect your GitHub account and select the everything-mcp-server repo.
4. Render should auto-detect the render.yaml (Blueprint) — if it asks, confirm you want to use it. If it doesn't auto-detect, configure manually:
   • Environment: Docker
   • Plan: Free
   • Health Check Path: /health
5. Click Create Web Service (or Apply if using the Blueprint).
6. Wait for the build/deploy logs to finish — you'll get a live URL like:

   https://everything-mcp-server.onrender.com
   

   Your MCP endpoint is:

   https://everything-mcp-server.onrender.com/mcp
   

Note: Render's free tier spins the service down after a period of inactivity and takes ~30-60 seconds to wake back up on the next request — normal for the free plan, not a bug.

4. Connect it to Claude

Remote MCP servers connect through Settings → Connectors → Add custom connector in Claude (claude.ai or Claude Desktop) — not through claude_desktop_config.json (that file is only for local stdio servers, like your weather server).

1. Open Claude → Settings → Connectors.
2. Click Add custom connector.
3. Enter a name (e.g. "My Everything Server").
4. Enter the URL: https://<your-app-name>.onrender.com/mcp
5. Click Add, then Connect.
6. Start a new chat and ask Claude to use one of the tools, e.g.:

   "Use the add tool to add 15 and 27" "Give me a random fact using my everything server"

Extending it

Add more tools by copying the server.registerTool(...) pattern in src/server.js — each tool needs a name, a Zod input schema, and an async handler that returns { content: [...] }.