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