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许可证。