JinDaGe - mcp-demo-server MCP Details

article

README

🚀 MCP 产品评论服务器

MCP 产品评论服务器是一个基于模型上下文协议（MCP）的服务器，它能够提供产品评论数据，还具备强大的搜索功能，为用户获取产品信息提供了便利。

🚀 快速开始

MCP 产品评论服务器为用户提供了便捷的产品评论数据获取与搜索途径。你可以通过以下步骤快速启动并使用该服务器。

✨ 主要特性

产品列表展示：将产品列表作为资源进行展示，方便用户查看。
多样化搜索工具：提供按产品 ID、评分和关键词搜索评论的工具，满足不同的搜索需求。
模拟 API：基于 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

高级用法

在本地部署

选择 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 使用：

启动 MCP 服务器：

python product_mcp_server.py

配置 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 文件。

mcp-demo-server