cnhkmcp 1.4.0__py3-none-any.whl → 1.4.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
cnhkmcp/__init__.py CHANGED
@@ -50,7 +50,7 @@ from .untracked.forum_functions import (
50
50
  read_full_forum_post
51
51
  )
52
52
 
53
- __version__ = "1.4.0"
53
+ __version__ = "1.4.1"
54
54
  __author__ = "CNHK"
55
55
  __email__ = "cnhk@example.com"
56
56
 
@@ -1194,12 +1194,13 @@ class BrainApiClient:
1194
1194
  self.log(f"Failed to get pyramid multipliers: {str(e)}", "ERROR")
1195
1195
  raise
1196
1196
 
1197
- async def get_diversity_score(self, start_date: str, end_date: str) -> Dict[str, Any]:
1197
+ async def value_factor_trendScore(self, start_date: str, end_date: str) -> Dict[str, Any]:
1198
1198
  """Compute diversity score for regular alphas in a date range.
1199
1199
 
1200
1200
  Description:
1201
- This diversity score measures three key aspects of work output: the proportion of works
1202
- with the "Atom" tag (S_A), atom porportion, the breadth of pyramids covered (S_P), and how evenly works
1201
+ This function calculate the diversity of the users' submission, by checking the diversity, we can have a good understanding on the valuefactor's trend.
1202
+ value factor of a user is defiend by This diversity score, which measures three key aspects of work output: the proportion of works
1203
+ with the "Atom" tag (S_A), atom proportion, the breadth of pyramids covered (S_P), and how evenly works
1203
1204
  are distributed across those pyramids (S_H). Calculated as their product, it rewards
1204
1205
  strong performance across all three dimensions—encouraging more Atom-tagged works,
1205
1206
  wider pyramid coverage, and balanced distribution—with weaknesses in any area lowering
@@ -1660,10 +1661,10 @@ async def authenticate(email: Optional[str] = "", password: Optional[str] = "")
1660
1661
 
1661
1662
 
1662
1663
  @mcp.tool()
1663
- async def get_diversity_score(start_date: str, end_date: str) -> Dict[str, Any]:
1664
+ async def value_factor_trendScore(start_date: str, end_date: str) -> Dict[str, Any]:
1664
1665
  """Compute and return the diversity score for REGULAR alphas in a submission-date window.
1665
-
1666
- This MCP tool wraps BrainApiClient.get_diversity_score and always uses submission dates (OS).
1666
+ This function calculate the diversity of the users' submission, by checking the diversity, we can have a good understanding on the valuefactor's trend.
1667
+ This MCP tool wraps BrainApiClient.value_factor_trendScore and always uses submission dates (OS).
1667
1668
 
1668
1669
  Inputs:
1669
1670
  - start_date: ISO UTC start datetime (e.g. '2025-08-14T00:00:00Z')
@@ -1673,7 +1674,7 @@ async def get_diversity_score(start_date: str, end_date: str) -> Dict[str, Any]:
1673
1674
  Returns: compact JSON with diversity_score, N, A, P, P_max, S_A, S_P, S_H, per_pyramid_counts
1674
1675
  """
1675
1676
  try:
1676
- return await brain_client.get_diversity_score(start_date=start_date, end_date=end_date)
1677
+ return await brain_client.value_factor_trendScore(start_date=start_date, end_date=end_date)
1677
1678
  except Exception as e:
1678
1679
  return {"error": str(e)}
1679
1680
 
@@ -34,11 +34,11 @@
34
34
  2. **社区动态**:从消息中提取社区相关信息,如研究论文或热门话题。
35
35
  3. **排行榜变化**:记录用户位置变化。
36
36
  - 使用工具:`mcp_brain-api_get_leaderboard`(设置 `user_id` 为用户 ID,如 "CQ89422")。
37
- 4. **多样性分数**:收集用户最近一个季度的多样性分数,提出具体建议。
37
+ 4. **多样性分数**:收集用户最近一个季度的多样性分数,获知其value factor趋势,该分数捕捉用户提交Alpha的多样性,来判断其value factor的变化趋势,在0-1之间,越高越好,据此提出具体建议。
38
38
  - **使用的 MCP 工具**:
39
39
  - `mcp_brain-api_get_messages`:获取平台公告和社区动态。
40
40
  - `mcp_brain-api_get_leaderboard`:获取用户排行榜统计。
41
- - `mcp_brain-api_get_diversity_scores`:获取用户多样性分数。
41
+ - `mcp_brain-api_value_factor_trendScore`:用户value factor趋势,又名多样性分数。
42
42
 
43
43
  ### 3. 比赛参与与进度
44
44
  - **步骤**:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cnhkmcp
3
- Version: 1.4.0
3
+ Version: 1.4.1
4
4
  Summary: A comprehensive Model Context Protocol (MCP) server for quantitative trading platform integration
5
5
  Home-page: https://github.com/cnhk/cnhkmcp
6
6
  Author: CNHK
@@ -1,8 +1,8 @@
1
- cnhkmcp/__init__.py,sha256=sziPMtlpV5JLwaObeqvLxL2cZIeUtMs7uyod9zaoOMg,2758
1
+ cnhkmcp/__init__.py,sha256=WGJVe8m7sQF-Msy1vWM1U9fP-GDYvDBKGXGDcUHUqdQ,2758
2
2
  cnhkmcp/untracked/arXiv_API_Tool_Manual.md,sha256=I3hvI5mpmIjBuWptufoVSWFnuhyUc67oCGHEuR0p_xs,13552
3
3
  cnhkmcp/untracked/arxiv_api.py,sha256=-E-Ub9K-DXAYaCjrbobyfQ9H97gaZBc7pL6xPEyVHec,9020
4
4
  cnhkmcp/untracked/forum_functions.py,sha256=QW-CplAsqDkw-Wcwq-1tuZBq48dEO-vXZ8xw7X65EuE,42303
5
- cnhkmcp/untracked/platform_functions.py,sha256=ba_rvLNvnGk5vafwIkWPddLd0coDXCSraut0QgRl7ik,116467
5
+ cnhkmcp/untracked/platform_functions.py,sha256=ybMnTUME9tzrXrfUynaT5lrwBqsjCWxw45ICB2wdxlI,116842
6
6
  cnhkmcp/untracked/sample_mcp_config.json,sha256=QSFvZ086bxUQsvmLjcE6pL9ObzKn4FGnt9npWPo7Eps,1044
7
7
  cnhkmcp/untracked/user_config.json,sha256=_INn1X1qIsITrmEno-BRlQOAGm9wnNCw-6B333DEvnk,695
8
8
  cnhkmcp/untracked/示例参考文档_BRAIN_Alpha_Test_Requirements_and_Tips.md,sha256=W4dtQrqoTN72UyvIsvkGRF0HFOJLHSDeeSlbR3gqQg0,17133
@@ -10,7 +10,7 @@ cnhkmcp/untracked/示例工作流_Alpha_explaination_workflow.md,sha256=QukeT9gI
10
10
  cnhkmcp/untracked/示例工作流_BRAIN_6_Tips_Datafield_Exploration_Guide.md,sha256=YyMX1MIsDTJTduxulY-fYipNHvRihshQy9Q2j6Zxg2Q,9123
11
11
  cnhkmcp/untracked/示例工作流_BRAIN_Alpha_Improvement_Workflow.md,sha256=XlWYREd_qXe1skdXIhkiGY05oDr_6KiBs1WkerY4S8U,5092
12
12
  cnhkmcp/untracked/示例工作流_Dataset_Exploration_Expert_Manual.md,sha256=-C4fWdaBe9UzA5BDZz0Do2z8RaPWLslb6D0nTz6fqk4,24403
13
- cnhkmcp/untracked/示例工作流_daily_report_workflow.md,sha256=tqB0L27xJe9JCPIpWqnuTD3GdfMywMa0B0mR3jda3Gs,9281
13
+ cnhkmcp/untracked/示例工作流_daily_report_workflow.md,sha256=6aNmPqWRn09XdQMRxoVTka9IYVOUv5LcWparHu16EfQ,9460
14
14
  cnhkmcp/untracked/APP/.gitignore,sha256=oPCoVTNo82bhkN0c671LdjCpOTVpVhZI5NR75ztcg48,317
15
15
  cnhkmcp/untracked/APP/MODULAR_STRUCTURE.md,sha256=Ji4VeRZjeMWRX6cvEHxyR_gmoorIEEdqwsXTCVIr5_0,4331
16
16
  cnhkmcp/untracked/APP/README.md,sha256=vb7hmQX0sH5aFNBmDCN5szMSDHm1_h2VKY4UKCt0aMk,11676
@@ -60,9 +60,9 @@ cnhkmcp/untracked/APP/templates/inspiration_house.html,sha256=CZMHj_ild-mUDRvNc5
60
60
  cnhkmcp/untracked/APP/templates/paper_analysis.html,sha256=7HgltBpZtmZCYCF7JU4wU9F5NMxUKyCXg7bCYCRfQDs,4139
61
61
  cnhkmcp/untracked/APP/templates/simulator.html,sha256=Y3-w-mZyvRiOdBiFe705CqBPAUI07KNY2WJ5meNzHM8,12508
62
62
  cnhkmcp/untracked/__pycache__/forum_functions.cpython-313.pyc,sha256=agARlP2x36scUU0TIYnrHB3EpEx4OOuHrB42_B1XR3k,45049
63
- cnhkmcp-1.4.0.dist-info/licenses/LICENSE,sha256=QLxO2eNMnJQEdI_R1UV2AOD-IvuA8zVrkHWA4D9gtoc,1081
64
- cnhkmcp-1.4.0.dist-info/METADATA,sha256=h0ZnKYlZFYIzZDtDX7VUCX9YLR0VAm9ivblz6Cj7W20,5171
65
- cnhkmcp-1.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
66
- cnhkmcp-1.4.0.dist-info/entry_points.txt,sha256=lTQieVyIvjhSMK4fT-XwnccY-JBC1H4vVQ3V9dDM-Pc,70
67
- cnhkmcp-1.4.0.dist-info/top_level.txt,sha256=x--ibUcSgOS9Z_RWK2Qc-vfs7DaXQN-WMaaxEETJ1Bw,8
68
- cnhkmcp-1.4.0.dist-info/RECORD,,
63
+ cnhkmcp-1.4.1.dist-info/licenses/LICENSE,sha256=QLxO2eNMnJQEdI_R1UV2AOD-IvuA8zVrkHWA4D9gtoc,1081
64
+ cnhkmcp-1.4.1.dist-info/METADATA,sha256=8QXfvDUdG-2voly-oEpTEWnANksdHsuX1DRfUamAhwI,5171
65
+ cnhkmcp-1.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
66
+ cnhkmcp-1.4.1.dist-info/entry_points.txt,sha256=lTQieVyIvjhSMK4fT-XwnccY-JBC1H4vVQ3V9dDM-Pc,70
67
+ cnhkmcp-1.4.1.dist-info/top_level.txt,sha256=x--ibUcSgOS9Z_RWK2Qc-vfs7DaXQN-WMaaxEETJ1Bw,8
68
+ cnhkmcp-1.4.1.dist-info/RECORD,,