Skip to main content
Glama
takehig

ProductMaster MCP Server

by takehig
README.md
# ProductMaster MCP Server

自然言語での曖昧検索に対応した商品情報管理システム用MCPサーバー

## 概要

ProductMaster APIを標準MCPプロトコルでラップし、Claude等のAIアシスタントから自然言語で商品検索を可能にします。

## 機能

### MCPツール

1. **search_products_flexible** - 柔軟な商品検索
   - 自然言語クエリ対応
   - 複数条件フィルタリング(商品タイプ、通貨、投資額、リスクレベル等)
   - ソート機能

2. **get_product_details** - 商品詳細情報取得
   - 商品コード指定での詳細情報取得

3. **get_product_statistics** - 商品統計情報取得
   - 商品タイプ別、通貨別、リスクレベル別統計
   - 投資額統計

## 技術仕様

- **MCPプロトコル**: JSON-RPC 2.0 over stdio transport
- **Python**: 3.8+
- **依存関係**: mcp, httpx, pydantic
- **ProductMaster API**: http://localhost:8001

## 使用例

```bash
# MCP Inspectorでテスト
npx @modelcontextprotocol/inspector python3 server/mcp_server.py

# 直接テスト
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | python3 server/mcp_server.py
```

## インストール

```bash
pip install -r requirements.txt
```

## 開発

- **ローカル開発**: /mnt/c/Users/takehig/QCHAT/.work/ProductMaster-MCP/
- **GitHub**: https://github.com/takehig/ProductMaster-MCP
- **EC2デプロイ**: /home/ec2-user/ProductMaster-MCP/