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

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