akshare-mcp 0.1.12

MCP server for akshare-rs — financial market data via Model Context Protocol
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use rmcp::schemars;

// ── Existing param types ──────────────────────────────────────────────

#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct IndexHkDailyParams {
    pub symbol: String,
    /// Eastmoney internal market id (e.g. "100", "124"). Get from index_hk_spot_em.
    pub internal_id: String,
    #[serde(default = "default_limit")]
    pub limit: usize,
}

#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct IndexSymbolParams {
    pub symbol: String,
}

#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct IndexCandlesParams {
    pub symbol: String,
    #[serde(default = "default_limit")]
    pub limit: usize,
}

#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct IndexHistParams {
    pub symbol: String,
    pub start_date: String,
    pub end_date: String,
}

const fn default_limit() -> usize {
    60
}

// ── New param types ──────────────────────────────────────────────────

/// Params for methods taking symbol + period (e.g. "daily"/"weekly"/"monthly").
#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct IndexPeriodParams {
    pub symbol: String,
    /// Period: "daily", "weekly", or "monthly".
    pub period: String,
}

/// Params for Eastmoney A-share index intraday with full arguments.
#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct IndexZhAHistMinEmParams {
    pub symbol: String,
    /// Period: "1", "5", "15", "30", or "60".
    pub period: String,
    #[serde(default)]
    pub start_date: String,
    #[serde(default)]
    pub end_date: String,
    /// Adjust: "qfq", "hfq", or "".
    #[serde(default)]
    pub adjust: String,
}

/// Params for Shenwan research analysis reports (date is a single date).
#[derive(serde::Deserialize, schemars::JsonSchema)]
pub struct SwAnalysisDateParams {
    /// Index type: "市场表征", "一级行业", "二级行业", "风格指数".
    pub symbol: String,
    /// Report date in YYYYMMDD or YYYY-MM-DD format.
    pub date: String,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_index_period_params() {
        let json = r#"{"symbol": "000300", "period": "daily"}"#;
        let params: IndexPeriodParams = serde_json::from_str(json).unwrap();
        assert_eq!(params.symbol, "000300");
        assert_eq!(params.period, "daily");
    }

    #[test]
    fn test_index_zh_a_hist_min_em_params() {
        let json = r#"{"symbol": "000300", "period": "5"}"#;
        let params: IndexZhAHistMinEmParams = serde_json::from_str(json).unwrap();
        assert_eq!(params.symbol, "000300");
        assert_eq!(params.period, "5");
        assert_eq!(params.start_date, "");
        assert_eq!(params.adjust, "");
    }

    #[test]
    fn test_sw_analysis_date_params() {
        let json = r#"{"symbol": "一级行业", "date": "20241025"}"#;
        let params: SwAnalysisDateParams = serde_json::from_str(json).unwrap();
        assert_eq!(params.symbol, "一级行业");
        assert_eq!(params.date, "20241025");
    }
}