HTTP代理服务器

一个轻量级的无数据库、无需配置的HTTP代理服务器,内置数据源,适用于快速开发和测试。

  • by 4xiaxia
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 4xiaxia/mcpcunpon

使用说明

优惠券-MCP服务器

一个最小化的MCP(模型上下文协议)服务器,用于将HTTP请求代理到内置数据源。

无数据库。无需认证。终端用户零配置。

发布在 npm 上作为 coupon-mcp-server.

特点/特性

  • 零配置:内置上游服务器,无需环境配置
  • MCP stdio 服务器,兼容 MCP 客户端
  • 通用HTTP代理工具和特定领域的工具
  • 轻量级、以JSON为主的响应

要求

  • Node.js 版本 >= 18.17

安装并运行(使用 npx)

无需本地安装,直接运行:

npx -y coupon-mcp-server

服务器通过标准I/O启动,并等待来自MCP客户端的连接。

MCP客户端集成

在您的MCP客户端配置(stdio)中添加:

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

无需设置环境变量。任何(条件/情况)均可 BASE_URL 环境变量被忽略。

工具

  • http.request
    • 输入: { method, path, query?, headers?, body? }
    • 示例: { "method": "GET", "path": "/coupons" }
  • coupon.create
    • 输入: { body }
  • coupon.get
    • 输入: { id }
  • coupon.list
    • 输入: { query? }
  • jutuike.public_promo_list
    • 输入: { query? }

使用示例

便捷工具:

{
  "query": { "page": 1, "size": 20 }
}

通用代理:

{
  "method": "GET",
  "path": "/api/mcp/jutuike/public_promo_list",
  "query": { "page": 1, "size": 20 }
}

行为

  • 如果上游是JSON(content-type: application/json),返回 { type: "json", json: ... }。
  • 否则返回 { type: "text", text: "Status <code>: <body>" }。

本地开发

npm install
node server.js

版本控制

  • 语义化版本控制。通过 npx 更新(获取最新版本)或 npm update coupon-mcp-server。

许可证

麻省理工学院(MIT)。参见 LICENSE。

安全通知

此服务器故意设置为开放状态(无需认证)。请勿用它来代理敏感/内部数据。