Communitygithub.com

smallke/cn-funds-mcp

Assistant de données boursières et de fonds chinois (API gratuite, sans clé API requise). Interrogez les valorisations, valeurs liquidatives, avoirs, informations sur les gestionnaires, cours des actions/indices, flux de capitaux, classements sectoriels, capitaux nordiques, et gérez votre portefeuille de fonds avec calcul des profits via les outils cn-funds-mcp.

Qu'est-ce que cn-funds-mcp ?

CN-Funds-MCP est un serveur MCP (Model Context Protocol) dédié aux données financières chinoises, conçu pour les agents IA comme Claude Code, Cursor ou Codex. Il offre un accès gratuit à une vaste gamme de données : fonds (valorisations en temps réel, valeurs liquidatives historiques, avoirs, gestionnaires), actions et indices (cotations, tendances intraday), flux de capitaux (marché général, sectoriel, capitaux nordiques du Hong Kong-Shanghai-Shenzhen Stock Connect). L'outil permet également de gérer un portefeuille utilisateur local (sauvegarde, consultation, calcul des profits) et de configurer des rappels programmés (synthèse des profits, rapports de marché, rappels personnalisés) qui se déclenchent automatiquement en début de conversation. Ce serveur est particulièrement utile pour les investisseurs individuels chinois, les analystes financiers ou tout utilisateur souhaitant interagir avec les marchés financiers chinois via une interface conversationnelle, sans nécessiter de clé API externe.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add smallke/cn-funds-mcp

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Guide d'utilisation de cn-funds-mcp

Référence rapide des outils

Recherche de fonds

OutilUtilisationParamètres clés
search_fundRechercher un fonds (nom/code/pinyin)keyword
get_fund_estimateValorisation en temps réel (estimation intraday et variation)fundCode
get_fund_batch_infoObtenir les valeurs liquidatives de plusieurs fonds en lotfundCodes (séparés par des virgules)
get_fund_infoDétails du fonds (type/société/gestionnaire/taille/classement)fundCode
get_fund_valuation_detailCourbe de valorisation du jour (intraday)fundCode
get_fund_net_value_historyHistorique des valeurs liquidativesfundCode, range
get_fund_accumulated_performancePerformance cumulée vs CSI 300 vs catégoriefundCode, range
get_fund_positionDétail des actions en portefeuillefundCode
get_fund_manager_listListe des gestionnaires successifsfundCode
get_fund_manager_detailPrésentation du gestionnaire actuelfundCode

Actions/Indices

OutilUtilisationParamètres clés
get_stock_trendTendance intradaysecid (ex. 1.600519)
get_stock_quoteCours en temps réelsecids (séparés par des virgules)

Marché/Capitaux

OutilUtilisationParamètres clés
get_market_overviewAperçu du marché A (Shanghai/Shenzhen)Aucun
get_market_capital_flowFlux de capitaux du marché (ordres importants/petits)Aucun
get_sector_capital_flowClassement sectoriel des flux de capitauxtimeType, code
get_northbound_capitalFlux de capitaux nordiques (Hong Kong-Shanghai-Shenzhen)Aucun

Gestion de portefeuille

OutilUtilisationParamètres clés
save_portfolioEnregistrer/mettre à jour une ligne de portefeuillefundCode, shares, costPrice
remove_portfolioSupprimer une ligne de portefeuillefundCode
get_portfolioVoir la liste du portefeuilleAucun
get_portfolio_profitConsulter en un clic le profit du jour et le totalAucun

Rappels programmés

OutilUtilisationParamètres clés
set_reminderConfigurer un rappel (déclenché chaque jour de bourse)time(HH:MM), type, message
get_remindersVoir tous les rappels configurésAucun
remove_reminderSupprimer un rappelid
check_remindersVérifier s'il y a des rappels à déclencherAucun

Types de rappel type :

  • profit_report — Bulletin des profits du portefeuille (déclenche la consultation de get_portfolio_profit, suggestions d'achat/vente)
  • market_report — Bulletin des marchés (déclenche la consultation de l'aperçu marché + flux de capitaux)
  • custom — Rappel personnalisé (avec le paramètre message)

Explication des paramètres courants

Code de fonds fundCode : 6 chiffres, ex. 161725 (Zhaoshang Baijiu), 110011 (Yifangda Small Cap)

ID de titre secid : Format marché.code

Code marchéSignificationExemple
1.Bourse de Shanghai1.000001 (indice Shanghai), 1.600519 (Kweichow Moutai)
0.Bourse de Shenzhen0.399001 (indice Shenzhen), 0.000858 (Wuliangye)
116.Bourse de Hong Kong116.01810 (Xiaomi Group)

Période range : m=1 mois, q=3 mois, hy=6 mois, y=1 an, 2y=2 ans, 3y=3 ans, 5y=5 ans

Comportements actifs (important)

Au début de chaque conversation, check_reminders doit être appelé

Peu importe ce que dit l'utilisateur, avant de répondre, appelez d'abord check_reminders pour vérifier s'il y a des rappels à déclencher. Si un rappel est à déclencher, exécutez les règles suivantes :

  1. À l'échéance de profit_report :

    • Appelez get_portfolio_profit pour obtenir les données de profit
    • Appelez get_market_overview pour le contexte du marché
    • Présentez à l'utilisateur un résumé convivial des profits du portefeuille du jour
    • Proposez des suggestions pour chaque fonds :
      • Baisse > 2 % : "Envisagez un achat supplémentaire pour réduire le coût moyen"
      • Hausse > 3 % : "Fort gain, envisagez de prendre partiellement vos bénéfices"
      • Perte totale > 10 % : "Perte importante, évaluez s'il faut conserver"
      • Gain total > 20 % : "Gain appréciable, envisagez de prendre vos bénéfices par étapes"
    • Demandez enfin à l'utilisateur s'il souhaite ajuster son portefeuille
  2. À l'échéance de market_report :

    • Appelez get_market_overview + get_market_capital_flow + get_northbound_capital
    • Rapport sur les indices, flux de capitaux et dynamique des capitaux nordiques
  3. À l'échéance de custom :

    • Affichez le contenu du rappel personnalisé à l'utilisateur

S'il n'y a aucun rappel à déclencher, traitez normalement la demande de l'utilisateur.

Scénarios typiques

L'utilisateur ne connaît pas le code du fonds

Utilisez d'abord search_fund pour rechercher, puis utilisez le code retourné pour appeler d'autres outils.

L'utilisateur demande "Comment est le marché aujourd'hui ?"

Appelez successivement get_market_overview + get_market_capital_flow, et présentez un rapport complet : niveaux d'indices, variations, volume d'échanges, flux de capitaux.

L'utilisateur demande "Combien ai-je gagné aujourd'hui ?"

Appelez directement get_portfolio_profit, qui retourne le profit du jour pour chaque fonds et un résumé. S'il n'y a aucune ligne de portefeuille, guidez l'utilisateur pour en ajouter avec save_portfolio.

L'utilisateur fournit des informations de portefeuille

Extrayez le code du fonds, le nombre de parts et le coût unitaire, puis appelez save_portfolio pour chaque ligne. Le paramètre de nom peut être omis, l'outil le complétera automatiquement.

L'utilisateur souhaite importer son portefeuille rapidement (reconnaissance de capture d'écran)

Si le modèle actuel prend en charge la reconnaissance d'image (OCR), proposez activement à l'utilisateur : vous pouvez directement télécharger une capture d'écran de votre portefeuille depuis une application de fonds (ex. Tiantian Fund, Alipay, Ant Fortune, etc.). L'IA reconnaîtra automatiquement les codes, noms, parts et coûts des fonds dans l'image, puis appellera save_portfolio pour chaque ligne pour importer le portefeuille en lot, sans saisie manuelle.

Processus :

  1. Reconnaissez les informations de chaque fonds sur la capture (code, parts, coût)
  2. Pour les champs incomplets (ex. nom seul sans code), utilisez search_fund pour compléter le code
  3. Appelez save_portfolio pour chaque ligne pour enregistrer
  4. Une fois terminé, présentez la liste du portefeuille importé et demandez à l'utilisateur de vérifier s'il manque ou si des erreurs subsistent

L'utilisateur demande une analyse complète d'un fonds

Combinez les appels : get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance, pour une analyse multidimensionnelle (fondamentaux, valorisation, portefeuille, historique).

L'utilisateur dit "Configure-moi un rappel de profit tous les après-midi"

Appelez set_reminder avec les paramètres time="14:30", type="profit_report". Chaque jour de bourse, la première conversation après 14:30 déclenchera automatiquement le bulletin de profit et les suggestions.

Exemple de bulletin après déclenchement d'un rappel

Bonjour ! Il est 14:30, voici le bulletin de votre portefeuille aujourd'hui :

Aperçu du portefeuille : 3 fonds, coût total 15000.00 yuans, valeur actuelle 14520.00 yuans Profit du jour : -180.00 yuans | Profit total : -480.00 yuans (-3.20%)

Détail par fonds :

  • Zhaoshang Baijiu A (161725) : Aujourd'hui -1.22%, perte totale -11.07%, évaluez s'il faut conserver
  • Yifangda Lanchou (005827) : Aujourd'hui +0.35%, gain total +5.20%, à conserver
  • Guangfa Nasdaq (270042) : Aujourd'hui +1.80%, gain total +15.30%, bonne tendance

Souhaitez-vous ajuster votre portefeuille ?

Remarques importantes

  • Les données de valorisation ne sont mises à jour que pendant les heures de bourse A (9h30-15h00). En dehors de ces heures, les données de clôture sont renvoyées.
  • get_fund_estimate renvoie une estimation, non la valeur liquidative finale. Veuillez en informer l'utilisateur.
  • Les données de portefeuille sont persistantes dans le fichier data/portfolio.json, conservées entre les sessions.
  • Calcul des profits : profit du jour = parts × (valorisation - valeur liquidative de la veille) ; profit total = parts × (valorisation - coût unitaire).

Auteur

smallke | [email protected]

Skills associés