Production-Ready FastMCP Server

MCP Server (FastMCP) and Client

Production-ready FastMCP server and a production-grade client with structured logging, env config, health checks, metrics, and containerization.

Features

Server: Stdio and SSE runtimes via FastMCP, CORS & security headers, token auth, basic rate limiting
Client: SSE and stdio transports, CLI to list tools/call tools/get resources, structured logs
Structured JSON logging with structlog
Env-based configuration
Health endpoints and CLI checks
Prometheus metrics primitives
Dockerfile and Makefile

Requirements

Python 3.9+

Setup

python3 -m venv .venv
. .venv/bin/activate
pip install -U pip
pip install -e .[dev]

Copy and adjust environment:

cp .env.example .env || true

Run (stdio)

mcp-server-stdio

Run (SSE)

mcp-server-sse  # uses HOST, PORT, AUTH_TOKEN, CORS_ORIGINS

Health

mcp-server-health

Docker

docker build -t mcp-server:latest .
docker run --rm -p 8000:8000 -e AUTH_TOKEN=changeme mcp-server:latest

Client CLI

Environment (SSE example):

export MCP_CLIENT_TRANSPORT=sse
export MCP_SSE_URL=http://localhost:8000/sse
export AUTH_TOKEN=changeme  # if server requires it

List tools:

mcpx list-tools

Call tool:

mcpx call-tool add --args '{"a": 1, "b": 2}'

Get resource:

mcpx get-resource time://now

Health check:

mcpx health

Security

Set a strong AUTH_TOKEN in production for SSE mode
Restrict CORS_ORIGINS to trusted origins
Run the container as non-root (Dockerfile does)
Prefer TLS for SSE (VERIFY_TLS=1)
Limit client network egress in production and rotate tokens regularly

RAG (Postgres + pgvector)

Set DATABASE_URL (or PG* envs) and OPENAI_API_KEY.
Enable vector extension in Postgres (the app will attempt to create it).

Ingest files via CLI:

python -m rag.cli ingest path/to/dir path/to/file.pdf

Ask a question via CLI:

python -m rag.cli ask "What does the document say about refunds?"

HTTP endpoints (when server running):

POST /rag/upload (multipart form with files)
POST /rag/query JSON { "question": "..." }

MCP tool:

rag_ask(question: str) -> str

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A production-grade MCP server and client implementation with comprehensive features including structured logging, health checks, metrics, authentication, and RAG capabilities with PostgreSQL vector search. Supports both stdio and SSE transports with containerization and security features for enterprise deployment.

Related MCP Servers

Supabase MCP Server
stefanraath3
-
security
A
license
-
quality
An MCP server that connects to Supabase PostgreSQL databases, exposing table schemas as resources and providing tools for data analysis through SQL queries.
Last updated -
1
MIT License
Simple PostgreSQL MCP Server
NetanelBollag
-
security
A
license
-
quality
A template project for building custom MCP servers that enables direct access to PostgreSQL databases, allowing SQL query execution and schema information retrieval through the Model Context Protocol.
Last updated -
30
MIT License
Simple PostgreSQL MCP Server
perrypixel
A
security
F
license
A
quality
A minimal MCP server that allows executing SQL queries on PostgreSQL databases with configurable read-only or write permissions.
Last updated -
1
7
PostgreSQL Read-Only MCP Server
currentspace
-
security
F
license
-
quality
A secure MCP server that enables querying PostgreSQL databases through an SSH tunnel with enforced read-only access, connection pooling, and comprehensive data exploration tools.
Last updated -

View all related MCP servers