MCP Datalink

🚀 @pilat/mcp-datalink

本項目是一個適用於PostgreSQL、MySQL和SQLite的MCP服務器，可通過模型上下文協議為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。

變量說明

連接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}"
      }
    }
  }
}

這允許重用現有的環境變量（例如來自shell或.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許可證。