MCP SSE
A working pattern for SSE-based MCP clients and servers
What is MCP SSE?
MCP SSE is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to working pattern for sse-based mcp clients and servers
A working pattern for SSE-based MCP clients and servers
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A working pattern for SSE-based MCP clients and servers
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-sseConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP SSE
The MCP SSE project provides a reference implementation and working pattern for building Server-Sent Events (SSE) based MCP servers and standalone clients, demonstrating how to decouple MCP servers from clients so they can run as independent network-accessible processes. The repository includes a functional weather server built on the National Weather Service API and a generic SSE client that connects to any SSE-based MCP server endpoint. Developers building cloud-native or multi-process MCP architectures use it as a template for moving beyond the traditional stdio transport.
Prerequisites
- Python 3.10 or higher with uv installed (pip install uv)
- The mcp and httpx Python packages
- An Anthropic API key (ANTHROPIC_API_KEY) for the bundled SSE client
- An MCP client that supports SSE transport, or use the included client.py
Clone the repository
Clone the mcp-sse repository to get the weather server and client implementations.
git clone https://github.com/sidharthrajaram/mcp-sse.git
cd mcp-sseInstall dependencies
Install Python dependencies using uv or pip.
uv sync
# or: pip install -r requirements.txtSet your Anthropic API key
The included client uses Claude to process tool results. Export your API key before running the client.
export ANTHROPIC_API_KEY=sk-ant-...Start the SSE weather server
Launch weather.py to start the MCP server on port 8080. It exposes get_alerts and get_forecast tools over SSE.
uv run weather.pyConnect the SSE client
In a separate terminal, run client.py pointing at the server's SSE endpoint. You can now send natural language queries to the weather tools.
uv run client.py http://0.0.0.0:8080/sseInstall via Smithery for Claude Desktop
Use Smithery to register the server with Claude Desktop automatically if you want to use it within Claude rather than the standalone client.
npx -y @smithery/cli install @sidharthrajaram/mcp-sse --client claudeMCP SSE Examples
Client configuration
Claude Desktop config for the SSE weather server running locally. Note that SSE transport support in Claude Desktop may require a compatible version.
{
"mcpServers": {
"mcp-sse-weather": {
"command": "python",
"args": ["weather.py"],
"env": {
"ANTHROPIC_API_KEY": "sk-ant-..."
}
}
}
}Prompts to try
Send weather queries through the SSE client to exercise the get_alerts and get_forecast tools.
- "What's the weather forecast for Chicago this weekend?"
- "Are there any severe weather alerts active in Florida right now?"
- "Get the current weather alerts for the state of California."
- "What will the weather be like in Denver, Colorado tomorrow?"
- "Check if there are any winter storm warnings in the Northeast US."Troubleshooting MCP SSE
client.py cannot connect to the SSE endpoint
Ensure weather.py is running in a separate terminal first. Verify with `curl http://0.0.0.0:8080/sse` — you should see a persistent SSE stream. If the port is in use, restart with `uv run weather.py --port 8081` and update the client URL accordingly.
No forecast data returned for a location
The National Weather Service API only covers US locations. Non-US locations will return empty results. Provide US city names, state abbreviations, or coordinates.
uv command not found
Install uv with `pip install uv` or via the official installer: `curl -LsSf https://astral.sh/uv/install.sh | sh`. Alternatively, use `python weather.py` directly after installing requirements with pip.
Frequently Asked Questions about MCP SSE
What is MCP SSE?
MCP SSE is a Model Context Protocol (MCP) server that working pattern for sse-based mcp clients and servers It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP SSE?
Follow the installation instructions on the MCP SSE GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP SSE?
MCP SSE works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP SSE free to use?
Yes, MCP SSE is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP SSE Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP SSE? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP SSE in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP SSE?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.