Neon MCP Server

Neon MCP Server

Neon MCP 伺服器是一個開源工具，使用者可以利用自然語言命令透過模型上下文協議 (Model Context Protocol) 與 Neon Postgres 數據庫互動，使數據庫管理對開發者和非開發者都變得容易。

Author: neondatabase-labs


查看協議

什麼是 Neon MCP 伺服器？

Neon MCP 伺服器是中介軟體，透過標準化的模型上下文協議 (MCP)，將自然語言請求轉換為精確的 Neon Postgres 數據庫操作。這允許基於大語言模型 (LLM) 的應用程序和代理工作流程執行如專案管理、架構遷移和查詢執行等任務，而無需直接進行 SQL 或 API 交互。Neon MCP 伺服器提供了豐富、可發現的「工具」，使 AI 客戶端能夠安全且高效地以程式化或對話方式管理 Postgres 資源。

如何配置 Neon MCP 伺服器

根據您對本地控制或雲端便利的偏好，有兩個主要設置選項：

選項 1：遠端 MCP 伺服器 (預覽)

  • 不需要本地安裝；使用 OAuth 認證。

  • 將以下配置添加到您的 MCP 客戶端 (例如 mcp.json)：

    {
  "mcpServers": {
    "Neon": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.neon.tech/sse"]
    }
  }
}

  • 重新啟動您的 MCP 客戶端，並按照瀏覽器提示完成 OAuth 授權。

選項 2：本地 MCP 伺服器

  • 需要 Node.js (>=v18.0.0)、npm 和您的 Neon API 金鑰。

  • 透過 Smithery CLI 安裝和配置：

    npx -y @smithery/cli@latest install neon --client <client_name>

    (將 <client_name> 替換為您的 MCP 客戶端名稱。)

  • 或者，將伺服器詳細信息添加到您的 MCP 配置：

    {
  "mcpServers": {
    "neon": {
      "command": "npx",
      "args": [
        "-y",
        "@neondatabase/mcp-server-neon",
        "start",
        "<YOUR_NEON_API_KEY>"
      ]
    }
  }
}

  • 對於 Windows，使用適當的 shell 或子系統 (例如 cmd, wsl) 並相應地調整配置。

如何使用 Neon MCP 伺服器

  1. 根據適當的配置指南設置 Neon MCP 伺服器 (本地或遠程)。
  2. 啟動配置好的 MCP 客戶端 (Claude Desktop、Cursor、VSCode 等)。
  3. 使用自然語言請求動作，例如：
    • "創建一個名為 'my-database' 的新 Postgres 數據庫並為用戶添加一個表。"
    • "運行架構遷移以在用戶表中添加一列。"
    • "列出我所有的 Neon 專案及其數據摘要。"
  4. 在執行前，當 MCP 客戶端提示時，檢查並授權建議的動作。
  5. 直接通過對話或程式化的 MCP 命令管理和監控 Neon 專案、分支、查詢、遷移和性能。

注意： 始終在批准之前檢查基於 LLM 的操作，以確保數據和訪問安全。

主要特點

  • 自然語言數據庫管理
    使用直觀的對話命令創建、修改或刪除 Postgres 資源。

  • 廣泛的工具支援
    透過 MCP 提供多種工具，涵蓋專案、分支、查詢和遷移操作。

  • 安全的架構遷移
    支援「準備」和「提交」的遷移模式，以安全測試架構變更，並通過臨時分支應用它們。

  • 性能洞察與查詢調優
    使用專用工具分析慢查詢、獲取執行計劃，並優化性能。

  • 安全性與認證
    支援 OAuth 和 Neon API 金鑰，確保只有授權用戶/應用程序能夠管理數據庫資源。

  • 靈活的部署
    可以選擇遠程雲端設置或本地伺服器安裝以獲取完全控制。

  • 非開發者友好
    使用者無需深入了解 SQL 或 API，便可管理數據庫。

使用案例

  • 通過聊天代理輕鬆創建和管理 Postgres 數據庫和表格。
  • 在 LLM 指導下安全自動化數據庫遷移，並支援回滾和測試。
  • 快速原型設計並管理開發、測試或驗證的分支。
  • 自動化報告或數據檢查任務，例如總結專案內容。
  • 在生產數據上針對性能查詢進行調優，使用 LLM 生成的建議。
  • 簡化非開發者或商業用戶的入門和數據庫操作。

常見問題

問：我可以在沒有 MCP 客戶端的情況下使用 Neon MCP 伺服器嗎？
答：不行，Neon MCP 伺服器設計用於通過 MCP 客戶端（如 Claude Desktop、Cursor 或兼容的 Model Context Protocol 工具）進行交互。

問：讓 LLM 管理我的數據庫是否安全？
答：Neon MCP 伺服器功能強大，允許敏感的數據庫操作。始終在批准之前檢查 LLM 生成的動作，並確保只有授權的用戶和服務可以訪問您的伺服器和 Neon API 金鑰。

問：我可以在自己的基礎設施中部署 Neon MCP 伺服器嗎？
答：可以，您可以在任何支持 Node.js 的本地環境運行，這樣您就可以完全掌控連接和憑證。

問：如果 Neon MCP 伺服器在我的客戶端中未顯示呢？
答：檢查您的 MCP 伺服器配置文件或安裝方法，並確保在更改後重新啟動您的客戶端。

問：我需要編寫 SQL 或了解 Neon API 結構才能使用嗎？
答：不需要，這個伺服器將 SQL 和 API 的細節抽象化，使得可以使用自然語言命令和直接調用工具。