Test Remort Server
This small project demonstrates a simple MCP server built with FastMCP.
You are using the uv package manager, so the instructions below show how to install dependencies and run the server with uv.
At a glance
Main code file:
main.pyLock file (pinned dependencies):
uv.lockPackage manager:
uv(Astral's uv)
Requirements
Python >= 3.12 (see
pyproject.toml)uvinstalled on your system —uvis a lightweight modern Python environment & package manager. Installation: https://docs.astral.sh/uv/getting-started/installation/
Note: If uv is not installed, follow the link above. uv typically manages both the virtual environment and package installation for the project.
Install dependencies (using uv)
Run this from the project root (where uv.lock and pyproject.toml live):
uv sync will read uv.lock and install the pinned dependency versions into the environment uv manages.
If you prefer not to use uv, you can create a normal Python virtual environment and use pip to install packages manually — however, using uv.lock via uv is recommended for reproducible installs.
Run the server
From the project root you can run the server inside uv's environment like this:
This runs the project's main.py using the Python environment managed by uv.
By default main.py binds the server to:
Host:
127.0.0.1Port:
5000
Open your browser or curl to:
Check the terminal output from uv run python main.py for available routes or log messages.
Useful uv commands (reference)
uv sync— Install/sync dependencies fromuv.lockuv run <command>— Run a command inside uv's managed environment (e.g.uv run pytest)uv pip install <pkg>— Run pip inside uv's environment to install a package (e.g.uv pip install fastmcp)
Troubleshooting
If
uvis not found (command not found), make sure you've installed it and that it's on your PATH. Installation guide: https://docs.astral.sh/uv/getting-started/installation/If
uv syncfails, check the terminal output; common causes are network / SSL issues or missing system build tools (e.g.build-essential,python3-dev,libssl-devon Linux).
Next steps (optional)
If you'd like, I can expose a small ASGI
appinmain.pyso you can also run the project via uvicorn, for example:
Tell me if you want that change and I will update main.py and add a couple of example curl requests.
This server cannot be installed
A simple MCP server that provides basic calculator functionality for performing mathematical operations. Built with FastMCP and demonstrates fundamental MCP server implementation patterns.