QUICKSTART.md•4.98 kB
# 🚀 台灣股票 MCP 服務器 - 快速開始指南
## 📦 你獲得了什麼?
一個功能完整的 MCP (Model Context Protocol) 服務器，專為台灣股票市場打造！
### 📁 檔案清單
```
taiwan_stock_mcp/
├── taiwan_stock_mcp.py # 主程式 (23KB)
├── README.md # 完整說明文件 (8KB)
├── EXAMPLES.md # 使用範例指南 (8.4KB)
├── test_taiwan_stock_mcp.py # 測試腳本 (5.6KB)
├── requirements.txt # 依賴套件清單
└── claude_desktop_config.json # Claude Desktop 配置範例
```
## ⚡ 3 分鐘快速部署
### 步驟 1: 安裝依賴 (30秒)
```bash
pip install mcp httpx pydantic
```
或使用 requirements.txt:
```bash
pip install -r requirements.txt
```
### 步驟 2: 測試運行 (1分鐘)
```bash
# 執行測試腳本確認一切正常
python test_taiwan_stock_mcp.py
```
你應該看到類似輸出:
```
✅ 測試 1: 獲取台積電(2330)即時資料
股票名稱: 台積電
成交價: 508.0
成交量: 38118 張
✅ 測試 2: 批量查詢多支股票
成功率: 3/3
✅ 測試 3-6: [所有測試通過]
```
### 步驟 3: 配置 Claude Desktop (1.5分鐘)
1. 找到配置文件位置:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
2. 編輯配置文件，添加:
```json
{
"mcpServers": {
"taiwan-stock": {
"command": "python",
"args": ["/完整路徑/taiwan_stock_mcp.py"]
}
}
}
```
**⚠️ 重要**: 將 `/完整路徑/` 替換為你實際存放檔案的路徑！
3. 重啟 Claude Desktop
## 🎉 開始使用!
重啟後，在 Claude 對話中輸入:
```
請查詢台積電(2330)的即時報價
```
你應該立即看到完整的股票資訊!
## 🎯 核心功能速覽
### 1️⃣ 即時報價
```
查詢台積電的股價
請告訴我 2330 現在多少錢
```
### 2️⃣ 技術分析
```
請分析台積電的技術面
給我台積電的完整分析報告
```
### 3️⃣ 買賣建議
```
我想買台積電，現在是好時機嗎？
台積電現在該賣出嗎？
```
### 4️⃣ 比較分析
```
請比較台積電、聯電、力積電
幫我比較這些半導體股：2330, 2303, 6770
```
### 5️⃣ 投資組合監控
```
請查詢我的投資組合：2330, 2317, 2454, 0050
監控這些金融股：2882, 2881, 2884
```
## 📚 更多資源
- **完整文件**: 閱讀 `README.md` 了解所有功能
- **使用範例**: 查看 `EXAMPLES.md` 學習實戰技巧
- **測試腳本**: 運行 `test_taiwan_stock_mcp.py` 驗證功能
## 💡 實用提示
### 提示 1: 自然語言查詢
不需要記住函數名稱，直接用中文問問題即可！
### 提示 2: 多維度分析
結合多個功能獲得更全面的投資視角:
```
1. 先查詢即時報價了解當前狀況
2. 再進行技術分析掌握趨勢
3. 最後比較同類股找出最佳標的
```
### 提示 3: 定期監控
建立每日檢查清單:
```
每天收盤前請幫我檢查投資組合：
[你的持股列表]
```
## ⚠️ 重要提醒
### 免責聲明
- 本工具提供的分析僅供參考，不構成投資建議
- 投資有風險，請謹慎評估並考慮個人風險承受能力
### 使用限制
- 遵守證交所 API 使用規範（每5秒最多3個請求）
- 資料來源為官方交易所，但仍可能有延遲
- 僅供個人使用，不得用於商業用途
## 🐛 遇到問題?
### 常見問題
**Q: 找不到股票資料**
A: 確認股票代碼是否正確（4-6位數字）
**Q: 連線失敗**
A: 檢查網路連線，證交所 API 可能暫時無法訪問
**Q: Claude 無法使用工具**
A: 確認配置文件路徑正確，並已重啟 Claude Desktop
### 測試連接
```bash
# 直接測試 API 連接
curl "https://mis.twse.com.tw/stock/api/getStockInfo.jsp?ex_ch=tse_2330.tw&json=1"
```
如果能看到 JSON 回應，表示 API 正常。
## 🎓 學習路徑
### 初學者
1. 從簡單查詢開始
2. 學習理解技術分析結果
3. 嘗試比較功能
### 進階使用者
1. 建立個人監控清單
2. 發展交易策略
3. 結合基本面研究
### 專業投資人
1. 客製化分析參數
2. 整合其他數據源
3. 建立自動化工作流程
## 🚀 下一步
1. ✅ 完成安裝和配置
2. ✅ 執行測試確認運作
3. ✅ 開始使用查詢功能
4. 📖 閱讀 `EXAMPLES.md` 學習進階技巧
5. 🎯 發展個人投資策略
6. 📈 持續優化投資組合
## 🌟 特色亮點
✨ **零成本**: 使用免費的證交所 API
🚀 **高效能**: 異步處理，快速回應
🎯 **智能分析**: 多維度技術指標
💡 **實用建議**: 基於量化分析的交易建議
🔒 **安全可靠**: 唯讀操作，不涉及交易
🇹🇼 **在地化**: 專為台灣股市優化
## 📞 支援
有問題或建議? 歡迎回饋!
---
**開始你的智能投資之旅! 🚀📈**
記住: 理性投資，風險管理第一！