NIUMA Premium MCP

把 NIUMA 店铺的 Session 型 REST API 封装为远程 MCP 服务，仅提供：

• X Premium 年费

• X Premium+ 年费

套餐价格、付款网络和币种从店铺 /context 实时读取；服务不会硬编码价格。

暴露的工具

每个 MCP 会话使用独立 PHP Session Cookie。服务不会把 Cookie 写入日志或返回给调用者。

Related MCP server: oda-mcp

本地运行

npm install
Copy-Item .env.example .env
npm start

健康检查：GET http://localhost:3000/health

MCP endpoint：http://localhost:3000/mcp

测试

npm test
npm run check

部署

可以部署到支持长期运行 Node.js 或 Docker 的平台。生产环境必须：

1. 提供公网 https:// 域名。

2. 保持单实例，或把 Session 存储替换成共享存储并启用会话粘性。

3. 设置 WEBSHOP_ORIGIN=https://lanv.niuma.works。

4. 设置 WEBSHOP_ENTRY_PATH=/p/niuma。

5. 建议设置 ALLOWED_HOSTS 为 MCP 服务自己的域名。

Docker：

docker build -t niuma-premium-mcp .
docker run --rm -p 3000:3000 `
  -e WEBSHOP_ORIGIN=https://lanv.niuma.works `
  -e WEBSHOP_ENTRY_PATH=/p/niuma `
  niuma-premium-mcp

部署后的上架 endpoint 应为：

https://你的-MCP-域名/mcp

不要使用 localhost、内网地址、临时隧道或示例占位域名上架。