MCP 产品评论服务器

一个提供产品评论数据和搜索功能的模型上下文协议（MCP）服务器。

功能

• 将产品列表作为资源进行展示
• 提供按产品 ID、评分和关键词搜索评论的工具
• 基于 AWS Lambda 函数的模拟 API，位于 /product-api/functions/ 目录下
• 设计用于与 CLINE 一起作为流式服务器使用

安装

该项目使用 uv 进行依赖管理。

# 安装依赖
uv pip install "mcp[cli]"

使用方法

启动 MCP 服务器

# 直接运行服务器
python product_mcp_server.py

# 或使用 MCP CLI
mcp run product_mcp_server.py

开发模式

用于测试和调试：

mcp dev product_mcp_server.py

在本地部署

1. 选择 stdio 运输方式，MCP 客户端与服务器通过本地标准输入输出进行通信：

   mcp.run(transport='stdio')
   

   如果服务器在本地运行，配置启动命令后，CLINE 可以通过 mcp run / uv run mcp run / unx 等命令启动这个服务器，CLINE 已经集成了 MCP 客户端代码，可以与服务器通信。

2. 选择 sse 运输方式，MCP 客户端与服务器通过本地标准输入输出进行通信：

   mcp.run(transport='sse')
   

   如果服务器在远程部署，无论是通过配置 /etc/systemd/system/mcp-server.service 使用 systemctl start mcp-server 命令启动，还是通过 mcp run / uv run mcp run / unx 等命令启动，都可以通过 {host}:{port}/sse 访问，在 CLINE 中配置如下进行使用：

   "{server name}": {
        "url": "http://{host}:{port}:8000/sse",
        "disabled": false,
        "autoApprove": []
      }
   

与 CLINE 集成

要将此服务器与 CLINE 使用：

1. 启动 MCP 服务器：

   python product_mcp_server.py
   

2. 配置 CLINE 连接到服务器（请参考 CLINE 文档中的具体步骤）

可用资源

• products://all - 获取所有产品的列表
• products://{product_id} - 获取特定产品的详细信息
• reviews://{product_id} - 获取特定产品的评论

可用工具

• get_products() - 获取所有可用产品的列表
• get_product_reviews(product_id) - 获取特定产品的评论
• search_reviews_by_rating(min_rating) - 搜索评分不低于指定值的评论
• search_reviews_by_keyword(keyword) - 搜索包含特定关键词的评论

AWS Lambda 函数

该服务器包含了位于 /product-api/functions/ 目录下的 AWS Lambda 函数的模拟实现：

• get_products.py - 返回产品列表
• get_product_reviews.py - 返回特定产品的评论

许可证

该项目在 MIT 许可证下发布，详情请参阅 LICENSE 文件。