SimpleServerSetup
About
A dual-mode Python calculator server supporting both Server-Sent Events (SSE) for web clients and Standard Input/Output (STDIO) for terminal interaction.
Details
- Author
- DionBenFernandes-Dev
- Downloads
- 323
- Categories
- Other
Jump to
- Dual-mode communication: SSE (HTTP) and STDIO (terminal)
- Real-time calculator results via Server-Sent Events
- Command-line calculator via standard input/output
- Consistent calculation logic across both modes
- Lightweight Python implementation for learning
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
SimpleServerSetupCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
What is Server-Sent Events (SSE)?
SSE is a web technology that enables a server to push real-time updates to a client over HTTP, used by the SSE client in this project.
What is Standard Input/Output (STDIO)?
STDIO is the traditional method for user interaction in the terminal, where input is provided via keyboard and output is printed to the screen, used by the STDIO client.
What are the prerequisites for running SimpleServerSetup?
Python 3.7 or higher is required,
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"simpleserversetup": {
"SimpleServerSetup": {
"command": "python",
"args": [
"server.py"
]
}
}
}
}McpServers
{
"SimpleServerSetup": {
"command": "python",
"args": [
"server.py"
]
}
}SimpleServerSetup
A simple Python project demonstrating calculator operations via two client-server communication modes: Server-Sent Events (SSE) and Standard Input/Output (STDIO). This project is ideal for learning about basic client-server architecture and dual-mode communication in Python.
---
File Structure
SimpleServerSetup/
├── .gitignore
├── .python-version
├── README.md
├── client-sse.py
├── client-stdio.py
├── pyproject.toml
├── requirements.txt
├── server.py
├── uv.lock
- .gitignore: Specifies files and directories to be ignored by Git.
- .python-version: Python version management file.
- README.md: Project documentation.
- client-sse.py: Python client using Server-Sent Events (SSE) to communicate with the server.
- client-stdio.py: Python client using Standard Input/Output (STDIO) for command-line interaction.
- pyproject.toml: Project metadata and build configuration.
- requirements.txt: Lists required Python packages.
- server.py: Main server logic supporting both SSE and STDIO modes.
- uv.lock: Dependency lock file for reproducible environments.
---
Key Terms
- Server-Sent Events (SSE): A web technology enabling a server to push real-time updates to a client over HTTP.
- Standard Input/Output (STDIO): Traditional method for user interaction in the terminal, where input is provided via keyboard and output is printed to the screen.
---
How the Project Works
SimpleServerSetup allows you to run a calculator service in two modes:
- SSE Mode:
- The server (server.py) starts an HTTP endpoint for SSE.
- The SSE client (client-sse.py) connects to the server, sends calculation requests, and receives results as real-time event streams.
- Useful for web-based or networked applications that require live updates.
- STDIO Mode:
- The server (server.py) can also handle requests from a command-line client (client-stdio.py).
- The client sends expressions via standard input and receives results via standard output.
- Ideal for quick, local calculations directly from the terminal.
Both modes use the same server logic, ensuring consistent calculation behavior.
---
Installation & Usage
Prerequisites:
- Python 3.7 or higher
Installation:
git clone https://github.com/DionBenFernandes-Dev/SimpleServerSetup.git
cd SimpleServerSetup
pip install -r requirements.txt
Running the Project:
- Start the Server:
python server.py
- Use STDIO Client:
python client-stdio.py
Enter expressions as prompted and receive results instantly.
- Use SSE Client:
python client-sse.py
This client will connect to the server and handle calculations via SSE.
---
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
