Dm MCP Server

🚀 達夢データベース MCP サービス

このプロジェクトは、達夢データベースに基づく MCP（マイクロサービス通信プロトコル）サービスで、以下の機能を提供します。

• データベース内のテーブルを一覧表示：list_tables ツールを使用して、指定されたデータベース内のすべてのテーブルを一覧表示します。
• 読み取り専用 SQL クエリを実行：execute_query ツールを使用して、読み取り専用 SQL クエリを実行します（SELECT、SHOW、DESCRIBE、EXPLAIN ステートメントのみサポート）。
• テーブル構造を表示：describe_table ツールを使用して、指定されたテーブルの構造を表示します。

🚀 クイックスタート

1. 環境要件

• Go バージョン：1.16 以上。
• 達夢データベース：達夢データベースがインストールされ、設定されていること。
• 依存ライブラリ：github.com/mark3labs/mcp-go ライブラリがインストールされていることを確認してください。

2. 依存関係のインストール

プロジェクトのルートディレクトリで以下のコマンドを実行して、Go Modules を初期化し、依存関係をダウンロードします。

go mod init dm-mcp-server
go mod tidy

3. データベース接続の設定

サービスを実行する前に、達夢データベースの接続情報を設定する必要があります。以下の方法で設定できます。

• コマンドライン引数：サービスを起動する際に、コマンドライン引数で指定します。
• 環境変数：環境変数で設定します。

コマンドライン引数

go run main.go \
  -username <ユーザー名> \
  -password <パスワード> \
  -host <ホストアドレス> \
  -port <ポート> \
  -schema <スキーマ名>

✨ 主な機能

• データベース内のテーブルを一覧表示：list_tables ツールを使用して、指定されたデータベース内のすべてのテーブルを一覧表示します。
• 読み取り専用 SQL クエリを実行：execute_query ツールを使用して、読み取り専用 SQL クエリを実行します（SELECT、SHOW、DESCRIBE、EXPLAIN ステートメントのみサポート）。
• テーブル構造を表示：describe_table ツールを使用して、指定されたテーブルの構造を表示します。

📦 インストール

Windows では、dm-mcp-server バイナリファイルを直接ダウンロードし、PATH に追加することができます。

go install を使用したインストール

go install github.com/wangzhaobo168/dm-mcp-server

達夢 MCP Server の設定例：

{
    "mcpServers": {
        "db-mcp-server": {
        "command": "dm-mcp-server",
        "args": [
        ],
        "env": {
            "DM_PORT": "ポート番号,デフォルト5236",
            "DM_HOST": "ホストアドレス",
            "DM_USERNAME": "アカウント",
            "DM_PASSWORD": "パスワード",
            "DM_SCHEMA": "スキーマ名"
        }
    }
}

dm-mcp-server のバージョンを確認する：

dm-mcp-server --version

💻 使用例

基本的な使用法

このサービスの基本的な使用方法は、上記のクイックスタートセクションで説明した通りです。

🔧 技術詳細

プロジェクト構造

dm-mcp-server/
├── main.go                # メインプログラムのエントリポイント
├── tools/                 # ツールの実装
│   ├── list_tables.go     # テーブルを一覧表示するツール
│   ├── execute_query.go   # クエリを実行するツール
│   └── describe_table.go  # テーブル構造を表示するツール
├── utils/                 # ユーティリティ関数
│   ├── config.go          # 設定管理
│   └── db.go              # データベース接続
├── go.mod                 # Go Modules ファイル
└── README.md              # プロジェクトドキュメント

🤝 貢献ガイド

このプロジェクトを改善するために、Issue と Pull Request の投稿を歓迎します。コードスタイルが一致し、テストを通過することを確認してください。

📄 ライセンス

このプロジェクトは MIT ライセンス の下で提供されています。

💡 使用アドバイス

• github.com/mark3labs/mcp-go ライブラリが利用できない場合は、他の互換性のある MCP 実装に置き換えてください。
• より多くのデータベース操作をサポートする必要がある場合は、tools パッケージに新しいツールを追加してください。