Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-promua

MCP服务器用于与Prom.ua API交互,为Claude等LLM模型提供商品和订单数据的获取、创建、更新和删除功能。

article

README

🚀 MCP 服务器用于 Prom.ua

MCP(模型上下文协议)服务器旨在与 Prom.ua 的 API 进行交互,它为 Claude 及其他 LLM 模型提供了通过 Prom.ua 的 API 获取和发送数据的能力,极大地增强了数据交互的便捷性。

🚀 快速开始

MCP 服务器是连接 Claude 等 LLM 模型与 Prom.ua API 的桥梁,让你可以轻松地进行数据的获取与发送。

✨ 主要特性

此服务器具备丰富的功能,涵盖了商品、订单和类别等多个方面的操作:

  • 获取商品列表(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 集成

你可以通过以下两种方式将服务器与 Claude Desktop 集成:

在 Claude Desktop 的设置中添加配置

在设置中添加以下 JSON 配置:

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

通过 Smithery 安装

使用以下命令进行安装:

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

使用 Docker

若你想使用 Docker 运行服务器,可执行以下命令:

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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client