fix: 修正審查員 P7-P8 問題

P7: envInputs 從 .paperclip.yaml 頂層移至 projects.daily-quant-pipeline.inputs.env
    讓 importer 能正確讀取 env input 並進 manifest
    同步補入 ALPACA_API_KEY / FMP_API_KEY 需求聲明

P8: .mcp.json 補齊 alpaca 與 fmp MCP server
    docs/agent-skill-mapping.md 新增 Runtime 狀態說明表(active / needs-key / local-runtime)
    docs/mcp-plan.md 狀態從「規劃中」改為「已配置」,補 Alpaca/FMP 安裝說明

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Chris
2026-04-10 21:31:44 +00:00
parent 3451ce7d77
commit e894446416
4 changed files with 85 additions and 14 deletions

View File

@@ -1,6 +1,6 @@
# MCP Server 配置計畫
> 狀態:規劃中(尚未實際配置
> 狀態:已配置(`.mcp.json` 已進 repoenv key 以 `${VAR}` 佔位
> 目標路徑:`KingClawArmy/.mcp.json`Paperclip claude_local adapter 啟動時自動載入)
> 需要安裝:`uv`、`Node.js >= 18`
@@ -12,11 +12,13 @@
|---|---|---|
| 🇹🇼 台股(上市/上櫃/加權指數) | CasualMarket、twsemcp、Fugle | 免費Fugle 需免費 key |
| 🇺🇸 美股(個股/選擇權/財報) | yahoo-finance-mcp | 免費免 key |
| 📊 美國總體經濟 | fred-mcp-server | 免費 key已取得 |
| 📊 美國總體經濟 | fred-mcp-server | 需 FRED_API_KEY免費申請 |
| 🌍 全球總體經濟 | openecon-data雲端 | 免費免 key |
| 📡 全球股市篩選 | tradingview-mcp-server | 免費免 key |
| ₿ 加密貨幣 | binance-mcp-server | 需 Binance API key |
| 📋 選擇權分析 | mcp-optionsflow | 免費免 key需 clone |
| 💼 財報行事曆 | fmp-mcp-server | 需 FMP_API_KEY免費方案可用 |
| 📈 投資組合管理 | alpaca-mcp-server | 需 ALPACA_API_KEY + SECRET |
---
@@ -274,6 +276,21 @@
"command": "python",
"args": ["<YOUR_PATH>/mcp-optionsflow/optionsflow.py"]
},
"alpaca": {
"command": "uvx",
"args": ["alpaca-mcp-server"],
"env": {
"ALPACA_API_KEY": "${ALPACA_API_KEY}",
"ALPACA_API_SECRET": "${ALPACA_API_SECRET}"
}
},
"fmp": {
"command": "uvx",
"args": ["fmp-mcp-server"],
"env": {
"FMP_API_KEY": "${FMP_API_KEY}"
}
},
"openecon-data": {
"type": "sse",
"url": "https://data.openecon.ai/mcp"
@@ -282,6 +299,8 @@
}
```
> 注意:`.mcp.json` 已進 repo使用 `${VAR}` 佔位符。實際部署時需在環境中設定對應 env var。
---
## 安裝前置作業清單
@@ -292,8 +311,10 @@
| 確認 Node.js ≥ 18 | `node --version` | 待確認 |
| clone mcp-optionsflow | `git clone https://github.com/twolven/mcp-optionsflow.git` + `pip install -r requirements.txt` | 待執行 |
| 申請 Fugle API key | https://developer.fugle.tw/docs/key | 待申請 |
| 填入 FRED API key | 填入 `YOUR_FRED_API_KEY` 至 .mcp.json | 待執行 |
| 建立 `.mcp.json` | 放入 KingClawArmy/ 根目錄 | 待執行 |
| 申請 FRED API key | https://fred.stlouisfed.org/docs/api/api_key.html | 待申請 |
| 申請 FMP API key | https://financialmodelingprep.com/developer/docs | 待申請 |
| 申請 Alpaca API key | https://alpaca.markets | 待申請portfolio-manager 才需要) |
| 設定環境變數 | 填入各 `${VAR}` 對應的真實值 | 待執行 |
| 設定 Claude Code 權限 | `{"enableAllProjectMcpServers": true}` | 待執行 |
---