MCP Datalink

🚀 @pilat/mcp-datalink

PostgreSQL、MySQL、SQLite用のMCPサーバーです。Model Context Protocolを介して、AIアシスタントに安全なデータベースアクセスを提供します。

npx @pilat/mcp-datalink

Claude Desktop、Claude Code、Cursor、Cline、およびMCP互換のクライアントと互換性があります。

🚀 クイックスタート

npx @pilat/mcp-datalink

📦 インストール

MCPクライアントの設定ファイルに追加してください（以下の設定ファイルの場所を参照）。

{
  "mcpServers": {
    "datalink": {
      "command": "npx",
      "args": ["-y", "@pilat/mcp-datalink"],
      "env": {
        "DATALINK_ANALYTICS_URL": "postgresql://user:password@localhost:5432/analytics",
        "DATALINK_ANALYTICS_READONLY": "true",

        "DATALINK_INVENTORY_URL": "mysql://user:password@localhost:3306/inventory",

        "DATALINK_CACHE_URL": "sqlite:///path/to/cache.db"
      }
    }
  }
}

これにより、analytics（読み取り専用）、inventory、cacheの3つのデータベース接続が作成されます。

接続URLの形式:

# PostgreSQL
postgresql://user:password@localhost:5432/dbname
postgresql://user:password@localhost:5432/dbname?sslmode=require

# MySQL
mysql://user:password@localhost:3306/dbname
mysql://user:password@localhost:3306/dbname?ssl=true

# SQLite
sqlite:///path/to/database.db
sqlite:///Users/me/data/app.sqlite
sqlite://../relative/path/data.db

環境変数の置換

URLは、他の環境変数を参照するために${VAR}構文をサポートしています。

{
  "mcpServers": {
    "datalink": {
      "command": "npx",
      "args": ["-y", "@pilat/mcp-datalink"],
      "env": {
        "DATALINK_MAIN_URL": "${DATABASE_URL}"
      }
    }
  }
}

これにより、既存の環境変数（シェルや.envファイルのDATABASE_URLなど）を再利用できます。

サポートされる構文:

例:

# 既存のDATABASE_URLを参照
DATALINK_MAIN_URL="${DATABASE_URL}"

# パーツからURLを構築
DATALINK_MAIN_URL="postgresql://${DB_USER}:${DB_PASS}@${DB_HOST}:5432/mydb"

# デフォルト値を使用
DATALINK_MAIN_URL="postgresql://localhost:${DB_PORT:-5432}/mydb"

設定ファイルの場所

🛠️ ツール

🔒 セキュリティ

• プリペアドステートメントのみ使用（SQLインジェクションなし）
• クエリごとに単一のステートメント（チェーンなし）
• DDLはブロックされる（DROP、ALTER、TRUNCATEなし）
• 接続ごとに読み取り専用モード
• レスポンスサイズ制限（デフォルトで100行、64KB、DATALINK_MAX_TOTAL_SIZEで設定可能）
• クエリタイムアウト：デフォルトで30秒、モデルは最大10分までリクエストでき、MAX_TIMEOUTで制限される

📄 ライセンス

MIT