MCP Demo Server

🚀 MCP 製品レビューサーバー

このサーバーは、製品レビューデータと検索機能を提供するモデルコンテキストプロトコル（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 ファイルを参照してください。