Agentsyun Coupon MCP Server

代理云优惠券MCP服务

这是一种基于MCP协议的优惠券服务，提供查询、过滤和生成多类优惠券的促销链接的功能，支持外卖、餐饮、休闲娱乐、酒店和民宿、门票和度假以及药品。

特性

• 支持查询6种主要类型的优惠券：

- 取出产品优惠券 - 餐饮优惠券 - 休闲娱乐优惠券 - 酒店和寄宿家庭优惠券 - 门票和度假券 - 药品优惠券

• 为优惠券提供完整的生命周期管理：

- 优惠券列表查询 - 促销链接生成（支持多种链接类型）

工具详细信息

优惠券列表查询

1. list_takeaway_coupons -外卖产品优惠券列表
2. list_restaurant_coupons -餐饮优惠券列表
3. list_entertainment_coupons -休闲娱乐优惠券列表
4. list_hotel_coupons -酒店和寄宿家庭优惠券列表
5. list_travel_coupons -门票和度假券清单
6. list_medical_coupons -药品优惠券列表

促销链接生成

1. get_takeaway_promotion_link -外卖产品优惠券促销链接
2. get_restaurant_promotion_link -餐饮优惠券促销链接
3. get_entertainment_promotion_link -休闲娱乐优惠券促销链接
4. get_hotel_promotion_link -酒店和寄宿家庭优惠券促销链接
5. get_travel_promotion_link -门票和度假券促销链接
6. get_medical_promotion_link -药品优惠券促销链接

详细工具说明

优惠券列表查询工具

\[list_takeawayy_coupons\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L130-L180）

检索外卖产品优惠券列表

• 函数：根据指定条件查询外卖券类别信息，支持搜索和分页
• 参数:

- search_text：搜索关键字（优惠券名称、店铺名称） - search_id：寻呼ID（第一次呼叫可选） - size：每页项目数，默认值为10 - current：当前页码，默认为1 - longitude：经度（必填） - latitude：纬度（必填）

• 返回值：包含优惠券数据或错误消息的词典

\[list_restaurant_coupons\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L233-L280）

检索餐饮优惠券列表

• 函数：查询餐券信息，支持搜索和分页
• 参数:

- search_text：搜索关键字（优惠券名称、店铺名称） - search_id：寻呼ID（第一次呼叫可选） - size：每页项目数，默认值为10 - current：当前页码，默认为1 - longitude：经度（必填） - latitude：纬度（必填）

• 返回值：包含优惠券数据或错误消息的词典

\[list_entertainment_coupons\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L335-L382）

检索休闲娱乐优惠券列表

• 函数：查询休闲娱乐优惠券信息
• 参数:

- search_text：搜索关键字（优惠券名称、店铺名称） - search_id：寻呼ID（第一次呼叫可选） - size：每页项目数，默认值为10 - current：当前页码，默认为1 - longitude：经度（必填） - latitude：纬度（必填）

• 返回值：包含优惠券数据或错误消息的词典

\[list_hotel_ops\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L434-L481）

检索酒店和寄宿家庭优惠券列表

• 函数：查询酒店和民宿优惠券信息
• 参数:

- search_text：搜索关键字（优惠券名称、店铺名称） - search_id：寻呼ID（第一次呼叫可选） - size：每页项目数，默认值为10 - current：当前页码，默认为1 - longitude：经度（必填） - latitude：纬度（必填）

• 返回值：包含优惠券数据或错误消息的词典

\[list_travel_coopons\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L533-L580）

检索机票和度假优惠券列表

• 函数：查询机票和度假券信息
• 参数:

- search_text：搜索关键字（优惠券名称、店铺名称） - search_id：寻呼ID（第一次呼叫可选） - size：每页项目数，默认值为10- current：当前页码，默认为1

• longitude：经度（必填）
• latitude：纬度（必填）
• 返回值：包含优惠券数据或错误消息的词典

\[list_medical_coupons\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L632-L679）

获取医疗优惠券列表

• 函数：查询医疗券信息
• 参数:

- search_text：搜索关键字（优惠券名称、店铺名称） - search_id：寻呼ID（第一次呼叫不需要） - size：每页项目数，默认值为10 - current：当前页码，默认为1 - longitude：经度（必填） - latitude：纬度（必填）

• 返回值：包含优惠券数据或错误消息的词典

促销链接生成工具

\[get_takeaway_provement_link\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L184-L229）

为外卖优惠券生成促销链接

• 函数：根据指定条件生成外卖优惠券的促销链接
• 参数:

- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2 - sku_id：优惠券的SKU ID（必填）

• 返回值：包含促销链接数据或错误消息的词典

\[get_restaurant_promotion_link\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L284-L331）

为餐厅优惠券生成促销链接

• 函数：根据指定条件生成餐厅优惠券的促销链接
• 参数:

- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2 - sku_id：优惠券的SKU ID（必填）

• 返回值：包含促销链接数据或错误消息的词典

\[get_intertainment_promotion_link\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L386-L430）

为休闲娱乐优惠券生成促销链接

• 函数：根据指定条件生成休闲娱乐优惠券的促销链接
• 参数:

- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2 - sku_id：优惠券的SKU ID（必填）

• 返回值：包含促销链接数据或错误消息的词典

\[get_hotel_provement_link\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L485-L529）

为酒店和寄宿家庭优惠券生成促销链接

• 函数：根据指定条件生成酒店和寄宿家庭优惠券的促销链接
• 参数:

- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2 - sku_id：优惠券的SKU ID（必填）

• 返回值：包含促销链接数据或错误消息的词典

\[get_travel_promotion_link\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L584-L628）

为门票和度假券生成促销链接

• 函数：根据指定条件生成门票和度假券的促销链接
• 参数:

- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2 - sku_id：优惠券的SKU ID（必填）

• 返回值：包含促销链接数据或错误消息的词典

\[get_medical_promotion_link\]（文件：//D:\\pyProject\\agentsyun_coupon_mcp_server\\agentsyun \_coupon_mcp_server \\server.py#L683-L728）

生成医疗优惠券的促销链接

• 函数：根据指定条件生成医疗优惠券的促销链接
• 参数:

- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2 - sku_id：优惠券的SKU ID（必填）

• 返回值：包含促销链接数据或错误消息的词典

首选 Agentsyun开放平台 得到你的 your_app_key 和 your_app_secret

环境要求

• Python>=3.12
• 环境变量配置：

- \[APP_KEY\]（文件：//D:\\pyProject\\huizhi_coupon_mcp_server\\agentsyun_coupon_mcp_servers\\server.py#L33-L33）：应用程序密钥（对应于APP ID）-\[APP_SECRET\]（文件://D:\\py Project\\huiji_cupon_mcp_server\\agentsyun_coupon_mcp.server.py#L34-L34）：应用机密（对应于APP SECRET）

快速开始

1.获取身份验证信息

转到 Agentsyun开放平台 获取您的APP_KEY（APP ID）和APP_SECRET（APP机密）。

• 对于stdio部署：

只需通过环境变量注入即可。 JSON { “mcpServers”：{ “代理商优惠券”：{ “命令”：“uvx”， “args”：\[ “agentsyun优惠券mcp服务器” \], “env”：{ “APP_KEY”：“您的APP_KEY来自开放平台”， “APP_SECRET”：“来自开放平台的APP_SECRET” } } } }

• 对于Volcano Engine的远程方法：

从火山引擎MCP介绍页面获取以下JSON文件。 令牌生成规则：base64（APP_KEY-APP_SECRET） 例如，如果APP_KEY为123456，APP_SECRET为abcdef，则实际生成的令牌将是123456 abcdef的base64编码（MTIzNDU2LWFiY2RlZg==）。 JSON { “mcpServers”：{ “agentsyun_mcp”：{ “url”：“https://sd40suov6n5j6uua1fiig.apigateway-cn-beijing.volceapi.com/mcp", “标题”：{ “授权”：“承载your_token” } } } }

注意：令牌中的APP_KEY和APP_SECRET将覆盖本地的APP_KEY和APP_SECRET。 开放平台地址：https://mcp.agentsyun.com

有关更详细的开发文档：https://agentsyun.feishu.cn/wiki/ZDlfwN37PiRqgbknMwYc3kO6nqd

2.开发者福利

• 开发人员可以从优惠券客户交易中获得佣金。
• 支持美团频道优惠券。
• 支持MCP渠道促销链接生成。

3.选择传输方式

从以下三种传输方式中选择一种：

• 标准 （默认）：本地调用
• SSE：远程服务调用
• 可流式传输http：远程服务调用

4.标准调用方法

首先，您需要在本地安装Python uv管理工具。安装文件：https://hellowac.github.io/uv-zh-cn/getting-started/installation/

标准传输的本地配置

只需在本地客户端中添加以下配置：

JSON { “mcpServers”：{ “代理商优惠券”：{ “命令”：“uvx”， “args”：\[ “agentsyun优惠券mcp服务器” \], “env”：{ “APP_KEY”：“您的APP_KEY来自开放平台”， “APP_SECRET”：“来自开放平台的APP_SECRET” } } } }

使用阿里云源作为替代方案

如果上述代码未能成功拉取，则可能是由于网络问题。您可以使用阿里云源代码：

JSON { “mcpServers”：{ “代理商优惠券”：{ “命令”：“uvx”， “args”：\[ “--索引url”， "https://mirrors.aliyun.com/pypi/simple/", “agentsyun优惠券mcp服务器” \], “env”：{ “APP_KEY”：“您的APP_KEY来自开放平台”， “APP_SECRET”：“来自开放平台的APP_SECRET” } } } }

SSE/流式执行，本地克隆代码，配置环境变量，并按如下方式执行：

1.SSE传输（需要在本地拉动包装）

SSE传输支持实时数据推送，适用于远程部署MCP服务器。

使用SSE在本地运行服务： bash 导出APP_KEY=您的应用密钥 导出APP_SECRET=您的应用密码 agentsyun优惠券mcp服务器sse

命令 设置APP_KEY=您的应用密钥 设置APP_SECRET=您的应用程序密码 agentsyun优惠券mcp服务器sse

PowerShell $env:APP_KEY=“您的应用密钥” $env:APP_SECRET=“您的应用程序密钥” agentsyun优惠券mcp服务器sse

MCP客户端配置：

• 根据实际服务器地址进行配置。

2.流式HTTP传输（需要在本地拉取包）

使用Streamable HTTP在本地运行服务： bash 导出APP_KEY=您的应用密钥 导出APP_SECRET=您的应用密码 agentsyun优惠券mcp服务器可流式传输http

MCP客户端配置：

• 根据实际服务器地址进行配置。

依赖项

• 主控程序
• 请求>=2.32.5
• 注释>=0.0.2

测试由于工具测试需要特定的纬度和经度，建议使用可以获取纬度和经度的工具，如网络搜索、AMap（高德地图），或直接提供纬度和经度。

ps：此流程的具体调用取决于您选择的模型功能。如果未成功获取数据，可以通过调整提示来引导模型。

由于此MCP服务依赖于特定地址的纬度和经度，您可以使用AMap的MCP地址反向查找工具或在线搜索功能来获取特定地址的经度和纬度（提示可以引导模型获取相应地址的经度），或者直接提供特定纬度和经度来调整提示并引导模型准确命中特定的MCP工具，例如：

• 使用搜索词“送餐”获取南京市雨花台区汇智大厦附近送餐券的短链接
• 使用搜索词“咖啡”获取南京雨花台区汇智大厦附近的外卖优惠券的短链接
• 使用搜索词“咖啡”获取南京市雨花台区汇智市附近外卖优惠券的5个短链接。南京市雨花台区汇芝市的经纬度为：118.754352,319.74435