Dm8 MCP

🚀 MCP DM8 サーバー

TypeScript版の達夢 DM8 Model Context Protocol (MCP) サービスです。表構造の閲覧と読み取り専用のクエリ機能を提供し、プロキシ接続に対応しています。

🚀 クイックスタート（推奨方法）

方法1：npxを直接使用（インストール不要）

npx mcp-dm8-server --host 127.0.0.1 --port 5236 --username SYSDBA --password パスワード --schema SYSDBA

方法2：グローバルにインストールして使用

# グローバルインストール
npm install -g mcp-dm8-server

# コマンドの使用
mcp-dm8 --host 127.0.0.1 --port 5236 --username SYSDBA --password パスワード --schema SYSDBA

方法3：プロキシ接続を使用

npx mcp-dm8-server \
  --host your_dm_host \
  --username SYSDBA \
  --password パスワード \
  --schema SYSDBA \
  --proxy-enabled \
  --proxy-host proxy.company.com \
  --proxy-port 8080 \
  --proxy-type http

⚙️ MCP クライアントの設定

Claude Desktopの設定（最も一般的）

設定ファイルの場所:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

基本設定（プロキシなし）

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "127.0.0.1",
        "--port", "5236",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA"
      ]
    }
  }
}

プロキシ設定（企業環境）

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "your_dm_host",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA",
        "--proxy-enabled",
        "--proxy-host", "proxy.company.com",
        "--proxy-port", "8080",
        "--proxy-type", "http"
      ]
    }
  }
}

環境変数設定（より安全）

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": ["-y", "mcp-dm8-server"],
      "env": {
        "DM_USERNAME": "SYSDBA",
        "DM_PASSWORD": "your_password",
        "DM_HOST": "your_dm_host",
        "DM_PORT": "5236",
        "DM_SCHEMA": "SYSDBA",
        "DM_DB_PROXY_ENABLED": "true",
        "DM_DB_PROXY_HOST": "proxy.company.com",
        "DM_DB_PROXY_PORT": "8080",
        "DM_DB_PROXY_TYPE": "http",
        "NODE_OPTIONS": "--openssl-legacy-provider"
      }
    }
  }
}

その他のMCPクライアントの設定

Cline (VSCode拡張機能)

VSCodeの設定 → Cline → MCP設定で設定します：

{
  "mcpServers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "127.0.0.1",
        "--port", "5236",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA"
      ]
    }
  }
}

mcp-routerの設定

~/.mcp-router/config.json で設定します：

{
  "servers": {
    "dm8": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dm8-server",
        "--host", "127.0.0.1",
        "--port", "5236",
        "--username", "SYSDBA",
        "--password", "your_password",
        "--schema", "SYSDBA"
      ],
      "env": {
        "NODE_OPTIONS": "--openssl-legacy-provider"
      }
    }
  }
}

🌐 プロキシサポートの詳細

サポートされるプロキシタイプ

• HTTP: 標準のHTTPプロキシ
• HTTPS: HTTPSプロキシ
• SOCKS4: SOCKS4プロキシ
• SOCKS5: SOCKS5プロキシ

設定パラメータ

環境変数設定の例

export DM_DB_PROXY_ENABLED="true"
export DM_DB_PROXY_HOST="proxy.company.com"
export DM_DB_PROXY_PORT="8080"
export DM_DB_PROXY_TYPE="http"

npx mcp-dm8-server --username SYSDBA --password パスワード --host your_dm_host --schema SYSDBA

🛠️ 利用可能なツール

⚠️ セキュリティ制限: SELECT/SHOW/DESCRIBE/EXPLAIN 文のみ実行可能です

📋 コマンドラインパラメータ

🔧 開発とローカルビルド

# プロジェクトをクローンする
git clone https://github.com/lianekai/mcp-dm8-server.git
cd mcp-dm8-server

# 依存関係をインストールする
npm install

# 開発モード
npm run dev

# ビルド
npm run build

# ローカルテスト
npm test

# ローカルで実行
node dist/index.js --host 127.0.0.1 --port 5236 --username SYSDBA --password パスワード --schema SYSDBA

📌 注意事項

Node.jsのバージョン要件

• Node.js 16.x: そのまま使用可能
• Node.js 18.x+: --openssl-legacy-provider パラメータを追加する必要があります

# Node.js 18+ の使用方法
NODE_OPTIONS=--openssl-legacy-provider npx mcp-dm8-server --host 127.0.0.1 --username SYSDBA --password パスワード --schema SYSDBA

セキュリティのベストプラクティス

1. パスワードのセキュリティ: 機密情報を環境変数に保存することをおすすめします
2. ネットワークセキュリティ: 企業環境ではプロキシ接続を使用します
3. 権限管理: 読み取り専用のデータベースユーザーを使用します
4. 監査ログ: データベースの監査機能を有効にします

🛡️ セキュリティ機能

• ✅ SQLインジェクション防止
• ✅ コネクションプール管理
• ✅ 読み取り専用クエリの強制
• ✅ 入力検証とタイムアウト制御
• ✅ 構造化ログ記録

❓ よくある質問

Q: Node.js 18+ で起動に失敗しますか？ NODE_OPTIONS=--openssl-legacy-provider パラメータを使用してください

Q: プロキシ接続に失敗しますか？

• プロキシサーバーの状態を確認してください
• プロキシのアドレスとポートを検証してください
• ネットワーク接続が正常であることを確認してください

Q: Claude Desktopでどのように使用しますか？ 設定を claude_desktop_config.json ファイルに追加してください

Q: どのようなデータベース操作がサポートされていますか？ 読み取り専用の操作のみサポートされています：SELECT、SHOW、DESCRIBE、EXPLAIN

📄 ライセンス

ISCライセンス

保守状態: 本番環境で使用可能、アクティブに保守されています npmパッケージ: mcp-dm8-server GitHub: lianekai/mcp-dm8-server