Go MCP Postgres

🚀 go-mcp-postgres

このプロジェクトは、https://github.com/Zhwt/go-mcp-mysql/ からコードをコピーし、AIの助けを借りてデータベースをMySQLからPostgreSQLに変更したものです。Model Context Protocol (MCP) サーバーを使用して、Postgresと自動化機能と簡単にやり取りできます。Node.jsやPython環境は不要です。このサーバーは、PostgresデータベースとテーブルのCRUD操作ツールを提供し、誤った書き込み操作を防ぐための読み取り専用モードも備えています。また、--with-explain-check フラグを追加することで、MCPサーバーがクエリを実行する前に EXPLAIN 文を使用してクエリ計画をチェックすることができます。

🚀 クイックスタート

このプロジェクトはまだ開発中であり、本番環境での使用はまだ準備ができていない可能性があります。

✨ 主な機能

• 最新の リリースバージョン を取得して、$PATH または他のアクセスしやすい場所に配置することで、簡単にインストールできます。
• Goがインストールされている場合は、ソースコードから直接ビルドすることもできます。
• コマンドライン引数を使用して、stdioモードまたは対話型モードで使用できます。
• データベースとテーブルのCRUD操作ツールを提供し、読み取り専用モードで誤った書き込み操作を防ぎます。
• --with-explain-check フラグを追加することで、クエリ実行前に EXPLAIN 文を使用してクエリ計画をチェックできます。

📦 インストール

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"
      ]
    }
  }
}

方法B：コマンドライン引数を使用した対話型モード

# PostgreSQLデータベースに接続
go-mcp-postgres postgresql://user:password@host:port/db

高度な使用法

このツールには、以下のようなコマンドとオプションが用意されています。

データベース接続

• --dsn または -d: データベース接続文字列の指定。
• --driver または -D: データベースドライバの指定（デフォルトは postgres）。

一般的なコマンド

• \help: 利用可能なすべてのコマンドを表示。
• \list: すべてのデータベースをリスト表示。
• \tables: 現在のデータベース内のテーブルをリスト表示。
• \schema: テーブル構造を表示。
• \exit または \q: プログラムを終了。

データベース操作

データベースの作成

CREATE DATABASE database_name;

データベースの削除

DROP DATABASE database_name;

データベースの使用

\c database_name;

テーブル操作

テーブルの作成

CREATE TABLE table_name (
  column1 datatype,
  column2 datatype,
  ...
);

テーブルの削除

DROP TABLE table_name;

データの挿入

INSERT INTO table_name (column1, column2, ...)
VALUES (value1, value2, ...);

データの更新

UPDATE table_name
SET column1 = new_value1,
    column2 = new_value2,
    ...
WHERE condition;

データの削除

DELETE FROM table_name
WHERE condition;

データのクエリ

SELECT column1, column2, ...
FROM table_name
[WHERE condition];

権限管理

アクセス権限の付与

GRANT ALL PRIVILEGES ON DATABASE database_name TO username;

アクセス権限の取り消し

REVOKE ALL PRIVILEGES ON DATABASE database_name FROM username;

📚 ドキュメント

注意事項

1. PostgreSQLサービスが正しくインストールされ、実行されていることを確認してください。
2. セキュリティを強化するために、強力なパスワードポリシーを使用してください。
3. データの損失を防ぐために、定期的にデータベースをバックアップしてください。

📄 ライセンス

MIT