Postgresql

🚀 MCP PostgreSQL 服務器

MCP PostgreSQL 服務器基於模型上下文協議（MCP）構建，藉助 MCP 工具實現對 PostgreSQL 數據庫的便捷操作，為數據庫管理提供高效解決方案。

🚀 快速開始

MCP PostgreSQL 服務器可通過一系列簡單步驟完成安裝與啟動，以下是詳細指引：

1. 克隆倉庫：

git clone https://github.com/a21071/mcp-postgres.git
cd mcp-postgres

2. 安裝依賴：

npm install

3. 配置 PostgreSQL 數據庫：

docker-compose up -d

4. 運行數據庫遷移：

npx prisma migrate dev

5. 構建項目：

npm run build

6. 運行服務器：

npm start

✨ 主要特性

• 實體 CRUD 操作：支持用戶和帖子實體的創建、讀取、更新和刪除操作。
• 類型安全操作：藉助 Prisma 實現類型安全的數據庫操作，保障數據處理的準確性。
• 工具接口兼容：提供與 MCP 兼容的工具接口，方便集成其他系統。
• 類型安全保障：採用 TypeScript 編寫，確保代碼的類型安全。

💻 使用示例

基礎用法

運行服務器：

npm start

高級用法

可用的 MCP 工具

• getData：從 PostgreSQL 檢索用戶數據

{
    "tableName": "user"
}

• addUserData：添加新用戶到數據庫

{
    "email": "user@example.com",
    "name": "John Doe",
    "age": 30
}

• deleteUserData：根據 ID、郵箱或名稱刪除用戶

{
    "id": "clxyz...",
    "email": "user@example.com",
    "name": "John Doe"
}

• updateUserData：更新用戶信息

{
    "id": "clxyz...",
    "email": "new@example.com",
    "name": "New Name"
}

🔧 技術細節

該服務器使用以下 Prisma 模式：

model User {
    id        String   @id @default(cuid())
    email     String   @unique
    name      String?
    age       Int?
    createdAt DateTime @default(now())
    posts     Post[]
}

📦 開發相關

監視模式

若需在開發過程中即時監控代碼變化，可使用監視模式：

npm run watch

📚 依賴項

• @modelcontextprotocol/sdk - MCP 服務器 SDK
• Prisma - 類型安全的數據庫客戶端
• TypeScript - 類型檢查

📄 許可證

本項目採用 MIT 許可證。