openGauss MCP server build with FastMCP

openGauss 用 Model Context Protocol サーバー

機能

• FastMCP 2.0 で構築されています。
• Stdio、SSE、Streamable-Http のトランスポート方式をサポートしています。
• MCP サーバーのトランスポート方式、待ち受けポート、ホスト、パスは、コマンドライン引数で設定できます。
• openGauss の接続パラメーターは、環境変数または .env ファイルで設定できます。

デプロイ

注：uv と python >= 3.12 が必要です。

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

openGauss の接続パラメーターは .env から読み込まれます。例：

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

同名の環境変数を設定すると、これらのパラメーターを上書きできます。

Claude Desktop での使用

Claude Desktop は Stdio モードのみをサポートしているため、claude_desktop_config.json に Stdio の起動コマンドを追加します：

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

CherryStudio での使用

CherryStudio は Stdio、SSE、Streamable-Http の3つのトランスポート方式すべてをサポートしています。

Stdio：

引数：

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

SSE：

SSE トランスポートモードでは、独立した MCP サーバーを起動する必要があります。プロジェクトのルートディレクトリで次のコマンドを実行するか、--directory でプロジェクトのルートディレクトリを指定して、任意のディレクトリから実行します：

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

次に、SSE MCP サーバーに接続するよう CherryStudio を設定します：

Streamable-Http：

Streamable-Http では、独立した MCP サーバーを起動する必要があります。プロジェクトのルートディレクトリで次のコマンドを実行するか、--directory でプロジェクトのルートディレクトリを指定して、任意のディレクトリから実行します：

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

次に、Streamable-Http MCP サーバーに接続するよう CherryStudio を設定します：