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) 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
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:
uv run python main.py
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:
http://127.0.0.1:5000
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:
uv run uvicorn main:app --host 127.0.0.1 --port 5000
Tell me if you want that change and I will update main.py and add a couple of example curl requests.