Dabouelhassan

You can run a lightweight MCP server that exposes a health check and a context endpoint to process parameterized prompts. This server is built with Python and FastAPI, making it easy to test prompt templates and see how your MCP client retrieves contextual information.

How to use

You interact with the server by calling two endpoints. The health check ensures the server is running, and the context endpoint returns a prepared context for a given prompt and set of parameters. Use your MCP client to send a request to the context endpoint with a prompt_id and a parameters object. The server responds with the generated context based on the prompt template and supplied values.

How to install

Prerequisites: Python 3.8 or newer and a functioning network environment.

Create and activate a virtual environment.

Install dependencies from the requirements file.

Run the server with the development server command.

python -m venv venv
source venv/bin/activate

pip install -r requirements.txt

uvicorn src.main:app --reload

Additional notes

The server provides two endpoints you should know about: a GET request to the root for health status and a POST request to /context to obtain a contextual output for a given prompt_id and parameters. Ensure your client handles JSON responses and tracks the status of the HTTP calls.

Available tools

healthCheck

Health check endpoint at GET / to verify the server is running and responsive.

contextEndpoint

Context endpoint at POST /context to retrieve contextual output for a given prompt_id and parameters.