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.py
Lock file (pinned dependencies):
uv.lock
Package manager:
uv
(Astral's uv)
Requirements
Python >= 3.12 (see
pyproject.toml
)uv
installed on your system —uv
is 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.1
Port:
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.lock
uv 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
uv
is 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 sync
fails, check the terminal output; common causes are network / SSL issues or missing system build tools (e.g.build-essential
,python3-dev
,libssl-dev
on Linux).
Next steps (optional)
If you'd like, I can expose a small ASGI
app
inmain.py
so 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.