openGauss

Servidor de Protocolo de Contexto de Modelo para openGauss

Recursos

• Construído com FastMCP 2.0.
• Suporta métodos de transporte Stdio, SSE e Streamable-Http.
• O método de transporte do servidor MCP, porta de escuta, host e caminho são configuráveis via argumento de linha de comando.
• Os parâmetros de conexão do openGauss são configuráveis por meio de variáveis de ambiente ou arquivos .env.

Implantação

Observação: uv e python >= 3.12 são necessários.

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

Os parâmetros de conexão do openGauss são carregados do .env, por exemplo:

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

Esses parâmetros podem ser sobrescritos se variáveis de ambiente idênticas forem definidas.

Uso com Claude Desktop

O Claude Desktop suporta apenas o modo Stdio, então adicionamos o comando de inicialização Stdio no claude_desktop_config.json:

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

Uso com CherryStudio

O CherryStudio suporta todos os três modos de transporte: Stdio, SSE e Streamable-Http

Stdio:

Argumentos:

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

SSE:

Para o modo de transporte SSE, precisamos iniciar um servidor mcp independente, execute o seguinte comando no diretório raiz do projeto, ou em qualquer diretório com --directory especificando o diretório raiz do projeto:

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

Em seguida, configure o CherryStudio para conectar ao servidor mcp sse:

Streamable-Http:

Para Streamable-Http, precisamos iniciar um servidor mcp independente, execute o seguinte comando no diretório raiz do projeto, ou em qualquer diretório com --directory especificando o diretório raiz do projeto:

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

Em seguida, configure o CherryStudio para conectar ao servidor mcp streamable-http: