openGauss

Servidor de Protocolo de Contexto de Modelo para openGauss

Características

• Construido con FastMCP 2.0.
• Soporta métodos de transporte Stdio, SSE y Streamable-Http.
• El método de transporte del servidor MCP, el puerto de escucha, el host y la ruta son configurables mediante argumentos de línea de comandos.
• Los parámetros de conexión de openGauss son configurables mediante variables de entorno o archivos .env.

Despliegue

Nota: se requiere uv y python >= 3.12.

git clone https://github.com/HowardQin/fastmcp-opengauss.git
cd fastmcp-opengauss
cp .env.example .env
uv sync

Los parámetros de conexión de openGauss se cargan desde .env, por ejemplo:

OPENGAUSS_HOST=172.32.148.228
OPENGAUSS_PORT=31001
OPENGAUSS_USER=app
OPENGAUSS_PASSWORD=Postgres1234
OPENGAUSS_DBNAME=app

Estos parámetros pueden sobrescribirse si se establecen variables de entorno idénticas.

Uso con Claude Desktop

Claude Desktop solo admite el modo Stdio, por lo que agregamos el comando de inicio Stdio en claude_desktop_config.json:

{
    "mcpServers": {
        "openGauss": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\Users\\qinh\\fastmcp-opengauss",
                "run",
                "server.py",
                "--transport",
                "stdio"
            ]
        }
    }
}

Uso con CherryStudio

CherryStudio admite los tres modos de transporte: Stdio, SSE y Streamable-Http

Stdio:

Argumentos:

--directory
C:\Users\qinh\fastmcp-opengauss
run
server.py
--transport=stdio

SSE:

Para el modo de transporte SSE, necesitamos iniciar un servidor mcp independiente, ejecute el siguiente comando en el directorio raíz del proyecto, o en cualquier directorio con --directory especificando el directorio raíz del proyecto:

uv --directory C:\Users\qinh\fastmcp-opengauss run .\server.py --transport=sse --port=8000 --path=/sse --host=0.0.0.0

Luego configure CherryStudio para conectarse al servidor mcp sse:

Streamable-Http:

Para Streamable-Http, necesitamos iniciar un servidor mcp independiente, ejecute el siguiente comando en el directorio raíz del proyecto, o en cualquier directorio con --directory especificando el directorio raíz del proyecto:

uv --directory C:\Users\qinh\fastmcp-opengauss run .\server.py --transport=streamable-http --port=8000 --path=/mcp --host=0.0.0.0

Luego configure CherryStudio para conectarse al servidor mcp streamable-http: