🔍 Web Tools MCP Server

A FastAPI + MCP (Model Context Protocol) server exposing web search & scraping tools via SSE transport. Deploy to Railway and connect to Claude.ai or any MCP-compatible client.

🛠️ Tools Available

Tool	Description
web_search	Search the web via DuckDuckGo (no API key needed)
search_news	Find recent news articles on any topic
scrape_url	Extract clean text content from any webpage
extract_links	Get all hyperlinks from a page (with optional keyword filter)
get_page_summary	Structured summary: title, description, headings outline

📁 Project Structure

mcp-server/
├── main.py              # FastAPI app + MCP server setup
├── tools/
│   ├── search.py        # web_search, search_news
│   └── scraper.py       # scrape_url, extract_links, get_page_summary
├── requirements.txt
├── railway.toml         # Railway deployment config
├── Procfile
└── README.md

🚀 Local Development

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

# 2. Install dependencies
pip install -r requirements.txt

# 3. Run the server
uvicorn main:app --reload --port 8000

# 4. Open in browser
# http://localhost:8000        → Info
# http://localhost:8000/health → Health check
# http://localhost:8000/sse   → MCP SSE endpoint

☁️ Deploy to Railway

Option A: GitHub (recommended)

1. Push this project to a GitHub repo
2. Go to railway.app → New Project → Deploy from GitHub
3. Select your repo → Railway auto-detects Python and deploys
4. Go to Settings → Networking → Generate Domain
5. Your MCP URL will be: https://your-app.railway.app/sse

Option B: Railway CLI

npm install -g @railway/cli
railway login
railway init
railway up

🔗 Connect to Claude.ai

1. Open claude.ai → Click your profile → Settings
2. Go to Integrations (or MCP Servers)
3. Click Add MCP Server
4. Enter your Railway URL: https://your-app.railway.app/sse
5. Save — Claude will now have access to all 5 tools!

🔗 Connect to Any MCP Client

Any MCP client that supports SSE transport can connect. Example config:

{
  "mcpServers": {
    "web-tools": {
      "url": "https://your-app.railway.app/sse",
      "transport": "sse"
    }
  }
}

📡 API Endpoints

Endpoint	Method	Description
/	GET	Server info + available tools
/health	GET	Health check
/sse	GET	MCP SSE transport endpoint

⚡ Why SSE for Claude.ai?

• Claude.ai remote MCP integrations use SSE transport
• SSE = server pushes events to client over a persistent HTTP connection
• Works through firewalls and proxies (unlike WebSockets)
• Railway supports long-lived connections ✅