cn-funds-mcp 使用指南
工具速查
基金查詢
| 工具 | 用途 | 關鍵參數 |
|---|---|---|
search_fund | 搜索基金(名稱/代碼/拼音) | keyword |
get_fund_estimate | 即時估值(盤中估算淨值和漲跌幅) | fundCode |
get_fund_batch_info | 批量獲取多隻基金淨值 | fundCodes(逗號分隔) |
get_fund_info | 基金詳情(類型/公司/經理/規模/排名) | fundCode |
get_fund_valuation_detail | 當日估值走勢(日內分時) | fundCode |
get_fund_net_value_history | 歷史淨值走勢 | fundCode, range |
get_fund_accumulated_performance | 累計收益 vs 滬深300 vs 同類 | fundCode, range |
get_fund_position | 持倉股票明細 | fundCode |
get_fund_manager_list | 歷任經理列表 | fundCode |
get_fund_manager_detail | 現任經理簡介 | fundCode |
股票/指數
| 工具 | 用途 | 關鍵參數 |
|---|---|---|
get_stock_trend | 日內分時走勢 | secid(如 1.600519) |
get_stock_quote | 即時行情報價 | secids(逗號分隔) |
大盤/資金
| 工具 | 用途 | 關鍵參數 |
|---|---|---|
get_market_overview | A股大盤概況(上證/深證) | 無 |
get_market_capital_flow | 大盤資金流向(主力/大小單) | 無 |
get_sector_capital_flow | 板塊資金排行 | timeType, code |
get_northbound_capital | 滬深港通資金流向 | 無 |
持倉管理
| 工具 | 用途 | 關鍵參數 |
|---|---|---|
save_portfolio | 保存/更新持倉記錄 | fundCode, shares, costPrice |
remove_portfolio | 刪除持倉記錄 | fundCode |
get_portfolio | 查看持倉列表 | 無 |
get_portfolio_profit | 一鍵查詢今日收益和總收益 | 無 |
定時提醒
| 工具 | 用途 | 關鍵參數 |
|---|---|---|
set_reminder | 設置定時提醒(每個交易日觸發) | time(HH:MM), type, message |
get_reminders | 查看所有提醒設置 | 無 |
remove_reminder | 刪除某個提醒 | id |
check_reminders | 檢查是否有到期提醒 | 無 |
提醒類型 type:
profit_report— 持倉收益播報(觸發後查詢get_portfolio_profit,給出加倉/減倉建議)market_report— 大盤行情播報(觸發後查詢大盤概況 + 資金流向)custom— 自定義提醒(配合message參數)
常用參數說明
基金代碼 fundCode: 6 位數字,如 161725(招商白酒)、110011(易方達中小盤)
證券ID secid: 格式為 市場.代碼
| 市場代碼 | 含義 | 示例 |
|---|---|---|
1. | 上交所 | 1.000001(上證指數)、1.600519(貴州茅台) |
0. | 深交所 | 0.399001(深證成指)、0.000858(五糧液) |
116. | 港股 | 116.01810(小米集團) |
時間範圍 range: m=1月, q=3月, hy=6月, y=1年, 2y=2年, 3y=3年, 5y=5年
主動行為(重要)
每次對話開始時,必須先調用 check_reminders
無論用戶說了什麼,在回應用戶之前,先調用 check_reminders 檢查是否有到期提醒。如果有到期提醒,按以下規則執行:
-
profit_report到期時:- 調用
get_portfolio_profit獲取收益數據 - 調用
get_market_overview獲取大盤背景 - 以友好的語氣向用戶播報今日持倉收益總覽
- 對每隻基金給出操作建議:
- 今日跌幅 > 2%:提示「可考慮適當加倉攤低成本」
- 今日漲幅 > 3%:提示「漲幅較大,可考慮部分止盈」
- 持倉總虧損 > 10%:提示「虧損較大,建議評估是否繼續持有」
- 持倉總盈利 > 20%:提示「盈利可觀,建議分批止盈鎖定收益」
- 最後詢問用戶是否需要調整持倉
- 調用
-
market_report到期時:- 調用
get_market_overview+get_market_capital_flow+get_northbound_capital - 播報大盤指數、資金流向、北向資金動態
- 調用
-
custom到期時:- 向用戶展示自定義提醒內容
如果沒有到期提醒,則正常處理用戶的請求。
典型場景
用戶不知道基金代碼
先用 search_fund 搜索,再用返回的 code 調用其他工具。
用戶問「今天大盤怎麼樣」
依次調用 get_market_overview + get_market_capital_flow,綜合播報大盤點位、漲跌、成交額、資金流向。
用戶問「我今天賺了多少」
直接調用 get_portfolio_profit,返回每隻基金的今日收益和匯總。如果沒有持倉記錄,引導用戶用 save_portfolio 添加。
用戶告知持倉信息
解析出基金代碼、份額、成本價,逐隻調用 save_portfolio 保存。名稱參數可省略,工具會自動查詢填充。
用戶想快速導入持倉(截圖識別)
如果當前模型支持圖片識別(OCR),主動提示用戶:可以直接上傳基金APP(如天天基金、支付寶、螞蟻財富等)的持倉截圖,AI 會自動識別圖片中的基金代碼、基金名稱、持有份額、成本淨值等信息,然後逐隻調用 save_portfolio 批量導入持倉,無需手動逐個輸入。
處理流程:
- 識別截圖中的每隻基金信息(代碼、份額、成本價)
- 對於識別不完整的字段(如只有名稱沒有代碼),用
search_fund補全基金代碼 - 逐隻調用
save_portfolio保存 - 保存完成後匯總展示已導入的持倉列表,並提示用戶確認是否有遺漏或錯誤
用戶問某隻基金的全面分析
組合調用: get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance,從基本面、估值、持倉、歷史收益多維度分析。
用戶說「幫我設置每天下午提醒收益」
調用 set_reminder,參數 time="14:30", type="profit_report"。之後每個交易日 14:30 後的首次對話會自動觸發收益播報和操作建議。
提醒觸發後的播報示例
下午好!現在是 14:30,為您播報今日持倉收益:
持倉總覽:3 隻基金,總成本 15000.00 元,當前市值 14520.00 元 今日收益:-180.00 元 | 持倉總收益:-480.00 元(-3.20%)
各基金明細:
- 招商白酒A (161725):今日 -1.22%,持倉虧損 -11.07%,建議評估是否繼續持有
- 易方達藍籌 (005827):今日 +0.35%,持倉盈利 +5.20%,繼續持有
- 廣發納斯達克 (270042):今日 +1.80%,持倉盈利 +15.30%,走勢良好
需要調整持倉嗎?
注意事項
- 估值數據僅在 A 股交易時段(9:30-15:00)更新,非交易時段返回的是收盤數據
get_fund_estimate返回的是估算值,非最終淨值,需提示用戶- 持倉數據持久化在
data/portfolio.json,跨會話保留 - 收益計算:今日收益 = 份額 ×(估值 - 昨日淨值),持倉收益 = 份額 ×(估值 - 成本價)