Mcp Demo Server

Mcp Demo Server

🚀 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

高级用法

在本地部署

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

  • 0 关注
  • 0 收藏,22 浏览
  • system 提出于 2025-10-04 00:42

相似服务问题

相关AI产品