go-mcp-postgres

go-mcp-postgres

概要

https://github.com/Zhwt/go-mcp-mysql/ のコードをコピーし、AI のサポートを受けて、データベースを MySQL から Postgres に変更しました。 Postgres との連携や自動化にすぐ使える、導入の負担がない Model Context Protocol（MCP）サーバーです。Node.js や Python の環境は必要ありません。このサーバーは、MySQL データベースとテーブルに対する CRUD 操作用のツールを提供し、予期しない書き込みを防ぐ読み取り専用モードも備えています。また、--with-explain-check フラグを追加すると、クエリを実行する前に EXPLAIN ステートメントを使ってクエリプランを確認するよう、MCP サーバーに指示できます。

現在も開発中のため、本番環境での使用にはまだ適さない可能性がありますのでご注意ください。

インストール

1. 最新のリリースを取得し、$PATH 内、または簡単にアクセスできる場所に配置します。

2. Go がインストールされている場合は、ソースからビルドすることもできます。

go install -v github.com/guoling2008/go-mcp-postgres@latest

使用方法

方法 A：stdio モードでコマンドライン引数を使用する

{
  "mcpServers": {
    "postgres": {
      "command": "go-mcp-postgres",
      "args": [
        "--dsn",
        "postgresql://user:pass@host:port/db"
      ]
    }
  }
}

注：バイナリを $PATH の外に配置した場合は、go-mcp-postgres をバイナリへのフルパスに置き換える必要があります。たとえば、バイナリを Downloads フォルダーに配置した場合は、次のパスを使用できます。

{
  "mcpServers": {
    "postgres": {
      "command": "C:\\Users\\<username>\\Downloads\\go-mcp-postgres.exe",
      "args": [
        ...
      ]
    }
  }
}

方法 B：sse モードでコマンドライン引数を使用する

./go-mcp-postgres --t sse --ip x.x.x.x --port nnnn --dsn postgresql://user:pass@host:port/db --lang en

任意のフラグ

• --lang：言語オプションを設定します（en/zh-CN）。デフォルトはシステム言語です。
• --read-only フラグを追加すると、読み取り専用モードが有効になります。このモードでは、名前が list、read_、desc_ で始まるツールのみ使用できます。このフラグを追加した後は、MCP サーバーを更新または再起動してください。
• デフォルトでは、生成されたクエリプランが想定されるパターンと一致するか確認するため、CRUD クエリはまず EXPLAIN ? ステートメントで実行されます。この動作を無効にするには、--with-explain-check フラグを追加してください。

ツール

多言語サポート：すべてのツールの説明は、lang パラメーターに応じて自動的にローカライズされます。

独自の言語サポートを追加する場合は、[locales](for i18n) フォルダーを参照してください。 コマンドラインで使用するには、新しい locales/xxx/active-xx.toml ファイルを作成してください。

スキーマツール

1. list_database

   • ${mcp.tool.list_database.desc}
   • パラメーター：なし
   • 戻り値：一致するデータベース名の一覧。

2. list_table

   • ${mcp.tool.list_table.desc}
   • パラメーター：
     • name：指定すると、その名前に一致するテーブルを一覧表示します。指定しない場合は、すべてのテーブルを一覧表示します。
   • 戻り値：一致するテーブル名の一覧。

3. create_table

   • ${mcp.tool.create_table.desc}
   • パラメーター：
     • query：テーブルを作成する SQL クエリ。
   • 戻り値：影響を受けた行数。

4. alter_table

   • Postgres サーバー上の既存のテーブルを変更します。LLM には、既存のテーブルや列を削除しないよう指示されます。
   • パラメーター：
     • query：テーブルを変更する SQL クエリ。
   • 戻り値：影響を受けた行数。

5. desc_table

   • テーブルの構造を説明します。
   • パラメーター：
     • name：説明するテーブルの名前。
   • 戻り値：テーブルの構造。

データツール

1. read_query

   • 読み取り専用の SQL クエリを実行します。
   • パラメーター：
     • query：実行する SQL クエリです。
   • 戻り値：クエリの結果です。

2. write_query

   • 書き込み SQL クエリを実行します。
   • パラメーター：
     • query：実行する SQL クエリです。
   • 戻り値：影響を受けた行数、最後に挿入された ID：<last_insert_id>。

3. update_query

   • 更新 SQL クエリを実行します。
   • パラメーター：
     • query：実行する SQL クエリです。
   • 戻り値：影響を受けた行数です。

4. delete_query

   • 削除 SQL クエリを実行します。
   • パラメーター：
     • query：実行する SQL クエリです。
   • 戻り値：影響を受けた行数です。

5. count_query

   • 特定のテーブルの行数を取得します。
   • パラメーター：
     • name：行数を取得するテーブルの名前です。
   • 戻り値：テーブルの行数です。

https://github.com/Zhwt/go-mcp-mysql/ にも改めて深く感謝します。

ライセンス

MIT