使用说明
MCP库存查询系统
基于 模型上下文协议（MCP） 使用自然语言查询解析。通过简单的CLI界面从雅虎财经获取实时股票价格。
✨ 特性
- 🔍 自然语言查询 -只需键入“苹果价格”或“AAPL”
- 📊 实时数据 -雅虎财经的实时股价
- 🛡️ CSV回退 -离线处理本地股票数据
- 🆓 没有API密钥 -开箱即用
- ⚡ 异步处理 -快速、无阻塞操作
🚀 快速开始
# Clone the repository
git clone https://github.com/YOUR_USERNAME/mcp-stock-server.git
cd mcp-stock-server
# Install dependencies
pip install -r requirements.txt
# Run the client
python mcp_client.py
📋 需求
- Python 3.10+
- 互联网连接（可选-CSV回退可用）
💬 使用示例
📊 Stock Query → AAPL
Stock: AAPL
Price: $286.10
Source: Yahoo Finance
📊 Stock Query → Compare Apple and Microsoft
AAPL ($286.10) is lower than MSFT ($481.22)
Difference: $195.12 (68.21%)
📊 Stock Query → What's the price of Tesla?
Company: Tesla, Inc.
Stock: TSLA
Price: $352.56
Source: Yahoo Finance
🏗️ 建筑
┌─────────────────┐ stdio ┌─────────────────┐
│ mcp_client.py │ ◄────────────► │ mcp_server.py │
│ (User Input) │ │ (Stock Tools) │
└─────────────────┘ └─────────────────┘
│
▼
┌────────────────────────┐
│ Yahoo Finance API │
│ (or CSV fallback) │
└────────────────────────┘
🛠️ 可用工具
| 工具 | 说明 | 示例 |
|---|---|---|
get_stock_price |
获取某个符号的当前价格 | “AAPL”，“微软价格” |
compare_stocks |
比较两种股票价格 | “比较AAPL和MSFT”，“TSLA与NVDA” |
📁 文件结构
mcp-stock-server/
├── mcp_client.py # Interactive CLI client
├── mcp_server.py # MCP server with stock tools
├── stocks_data.csv # Fallback stock data
├── requirements.txt # Python dependencies
└── README.md
🔧 配置
无需配置！ 系统：
- 自动检测项目目录
- 使用当前的Python解释器
- 如果雅虎财经不可用，则返回CSV
向CSV回退添加更多股票
编辑 stocks_data.csv:
symbol,price,last_updated
NEWSTOCK,123.45,2024-12-03
❓ 故障排除
| 问题 | 解决方案 |
|---|---|
| “无法检索价格” | 检查符号拼写，或添加到 stocks_data.csv |
| “无法理解查询” | 使用更简单的格式：“AAPL”或“苹果价格” |
| 雅虎财经错误 | 系统自动回退到CSV数据 |
| 导入错误 | 运行 pip install -r requirements.txt |
📦 依赖项
- mcp[cli] -模型上下文协议框架
- y融资 -雅虎财经API包装器
📄 许可证
MIT许可证-随意使用和修改！
备注：这是一个简化的演示，使用模式匹配而不是人工智能进行查询解析，使其轻量级且可自由运行。
