Http Sse MCP Starter

🚀 MCP Server Based on HTTP SSE (with Wikipedia Article Tool)

This is an MCP (Model Context Protocol) server based on HTTP SSE (Server-Sent Events), integrated with a tool for fetching and converting Wikipedia articles into Markdown format.

🚀 Quick Start

✨ Features

• An MCP server implemented with FastMCP.
• Communication between the client and the server via SSE (Server-Sent Events).
• A tool for fetching Wikipedia articles.
• Conversion of HTML content to Markdown format.

📦 Installation

• Python 3.8+
• Dependencies listed in requirements.txt
• uv (Python package manager)

# Clone the repository
git clone https://github.com/codingaslu/http-sse-mcp-starter.git
cd http-sse-mcp-starter

# Install dependencies using uv
uv pip install -r requirements.txt

💻 Usage Examples

Basic Usage

# Start the server
python server.py

The server will start at http://localhost:8000 and provide the following endpoints:

• /sse: For SSE connections from clients.
• /messages/: To handle incoming POST messages.

# List server functions
uv run -- client.py http://localhost:8000/sse

# Fetch a Wikipedia article
uv run -- client.py http://localhost:8000/sse https://en.wikipedia.org/wiki/Python_(programming_language)

📚 Documentation

The MCP server provides:

• Tools: Functions that clients can call.
• Resources: Data resources available for clients.
• Prompts: Pre - defined prompt information for AI assistants.

The read_wikipedia_article tool is used to fetch articles from Wikipedia, parse their content, and convert it to Markdown format.

📄 License

MIT License