返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端