MCP Server Promua

🚀 MCP 服務器用於 Prom.ua

MCP（模型上下文協議）服務器旨在與 Prom.ua 的 API 進行交互，它允許 Claude 和其他大語言模型（LLM）通過 Prom.ua 的 API 實現數據的獲取與發送。

🚀 快速開始

MCP 服務器為與 Prom.ua 的 API 交互提供了便捷途徑，能讓 Claude 等模型順利獲取和發送數據。以下將為你詳細介紹其使用方法。

✨ 主要特性

此服務器具備豐富的功能，涵蓋了商品、訂單和類別等多方面的操作：

• 商品操作：
  • 獲取商品列表（GET）
  • 獲取商品詳情（GET）
  • 創建新商品（POST）
  • 更新現有商品（PUT）
  • 刪除商品（DELETE）
• 訂單操作：
  • 獲取訂單列表（GET）
  • 獲取訂單詳情（GET）
  • 更新訂單狀態（PUT）
• 類別操作：
  • 獲取類別列表（GET）

📦 安裝指南

全局安裝

可使用以下命令進行全局安裝：

npm install -g mcp-server-promua

通過 npx 使用

若不想全局安裝，可通過 npx 直接使用：

npx mcp-server-promua

📚 詳細文檔

配置

在使用服務器之前，需要配置 Prom.ua 的 API 密鑰，以下為你提供兩種配置方法：

通過 .env 文件配置

在項目根目錄下創建 .env 文件，並添加以下內容：

PROMUA_API_KEY=your_api_key_here
PROMUA_API_URL=https://my.prom.ua

通過環境變量配置

在終端中執行以下命令：

export PROMUA_API_KEY=your_api_key_here
export PROMUA_API_URL=https://my.prom.ua

與 Claude Desktop 集成

你可以通過以下兩種方式將 MCP 服務器與 Claude Desktop 集成：

手動配置

在 Claude Desktop 的設置中添加以下配置：

{
  "mcpServers": {
    "promua": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-promua"
      ]
    }
  }
}

通過 Smithery 安裝

使用以下命令進行安裝：

npx -y @smithery/cli install mcp-server-promua --client claude

使用 Docker

若你想使用 Docker 部署 MCP 服務器，可按以下步驟操作：

docker build -t mcp-server-promua .
docker run -e PROMUA_API_KEY=your_api_key_here mcp-server-promua

開發

如果你想對項目進行開發，可按以下步驟操作：

# 克隆倉庫
git clone https://github.com/bigcatchkm/mcp-server-promua.git
cd mcp-server-promua

# 安裝依賴
npm install

# 啟動開發模式
npm run dev

# 構建
npm run build

# 運行構建版本
npm start

📄 許可證

本項目採用 MIT 許可證。