README.md•1.47 kB
# 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/