akshare-one-mcp

# AKShare One MCP 服务器 <div align="center"> <a href="README.md">English</a> | <a href="README_zh.md">中文</a> </div> [](https://smithery.ai/server/@zwldarren/akshare-one-mcp) 这是一个基于 [akshare-one](https://github.com/zwldarren/akshare-one) 的 MCP (Model Context Protocol) 服务器，为中国股票市场提供全面的数据接口服务。 <a href="https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp/badge" alt="akshare-one-mcp MCP 服务器" /> </a> ## 功能特性 - **历史数据**: 获取股票历史行情数据，支持多种时间周期和复权方式 - **实时数据**: 提供实时股票行情信息 - **新闻资讯**: 获取股票相关的最新新闻资讯 - **财务报表**: 查看公司资产负债表、利润表、现金流量表 - **分析指标**: 计算关键财务指标和技术分析指标 ## 工具说明 ### 市场数据 #### `get_hist_data` - 获取历史股票数据 获取指定股票的历史行情数据，支持多种数据源和复权方式。 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码，如 '000001' - `interval` (string, 可选): 时间周期，可选值：'minute'(分钟)、'hour'(小时)、'day'(日线)、'week'(周线)、'month'(月线)、'year'(年线)，默认 'day' - `start_date` (string, 可选): 开始日期，格式：YYYY-MM-DD，默认 '1970-01-01' - `end_date` (string, 可选): 结束日期，格式：YYYY-MM-DD，默认 '2030-12-31' - `adjust` (string, 可选): 复权方式，'none'(不复权)、'qfq'(前复权)、'hfq'(后复权)，默认 'none' - `source` (string, 可选): 数据源，'eastmoney'(东方财富)、'eastmoney_direct'(东方财富直连)、'sina'(新浪)，默认 'eastmoney' - `indicators_list` (list, 可选): 技术指标列表 - `recent_n` (number, 可选): 返回最新记录数，默认 100 </details> #### `get_realtime_data` - 获取实时股票数据 <details> <summary>参数说明</summary> - `symbol` (string, 可选): 股票代码，留空获取所有股票概览 - `source` (string, 可选): 数据源，'xueqiu'(雪球)、'eastmoney'(东方财富)、'eastmoney_direct'(东方财富直连)，默认 'eastmoney_direct' </details> ### 新闻资讯 #### `get_news_data` - 获取股票新闻 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码 - `recent_n` (number, 可选): 返回最新记录数，默认 10 </details> ### 财务报表 #### `get_balance_sheet` - 获取资产负债表 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码 - `recent_n` (number, 可选): 返回最新记录数，默认 10 </details> #### `get_income_statement` - 获取利润表 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码 - `recent_n` (number, 可选): 返回最新记录数，默认 10 </details> #### `get_cash_flow` - 获取现金流量表 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码 - `source` (string, 可选): 数据源，默认 'sina' - `recent_n` (number, 可选): 返回最新记录数，默认 10 </details> ### 分析指标 #### `get_inner_trade_data` - 获取内部交易数据 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码 </details> #### `get_financial_metrics` - 获取财务指标 <details> <summary>参数说明</summary> - `symbol` (string, 必填): 股票代码 - `recent_n` (number, 可选): 返回最新记录数，默认 10 </details> #### `get_time_info` - 获取时间信息 获取当前时间、时间戳和最近一个交易日信息。 ## 运行模式 服务器支持两种运行模式：**stdio** 和 **streamable-http** ### 命令行参数 - `--streamable-http`: 启用 HTTP 模式 (默认为 stdio 模式) - `--host`: HTTP 模式绑定的主机地址 (默认: 0.0.0.0) - `--port`: HTTP 模式监听的端口 (默认: 8081) > **说明:** 启用 streamable-http 模式后，MCP 服务器将在 `http://{host}:{port}/mcp` 提供服务。默认地址为 `http://0.0.0.0:8081/mcp` ## 安装指南 ### 通过 Smithery 安装 通过 [Smithery](https://smithery.ai/server/@zwldarren/akshare-one-mcp) 自动安装，适用于 Claude Desktop： ```bash npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude ``` ### 快速安装 如果尚未安装 [uv](https://docs.astral.sh/uv/getting-started/installation/)，请先安装。 在 MCP 客户端配置中添加以下设置： ```json { "mcpServers": { "akshare-one-mcp": { "command": "uvx", "args": ["akshare-one-mcp"] } } } ``` ### 通过代码库本地安装 1. **克隆仓库** ```bash git clone https://github.com/zwldarren/akshare-one-mcp.git cd akshare-one-mcp ``` 2. **安装依赖** ```bash uv sync ``` 3. **配置 MCP 客户端** ```json { "mcpServers": { "akshare-one-mcp": { "command": "uv", "args": [ "--directory", "/path/to/akshare-one-mcp", "run", "akshare-one-mcp" ] } } } ``` ## 技术指标 `get_hist_data` 工具支持下面这些技术分析指标： ### 趋势指标 - **移动平均**: SMA (简单移动平均)、EMA (指数移动平均) - **趋势跟踪**: MACD (指数平滑异同移动平均线)、APO (价格振荡器)、PPO (百分比价格振荡器) - **变化率**: ROC (变化率)、ROCP (变化率百分比)、ROCR (变化率比率)、ROCR100 - **其他**: TRIX (三重指数平滑移动平均)、ULTOSC (终极振荡器) ### 动量指标 - **相对强弱**: RSI (相对强弱指数)、CCI (商品通道指数) - **趋势强度**: ADX (平均趋向指数)、DX (趋向指数) - **资金流向**: MFI (资金流量指标)、MOM (动量)、CMO (钱德动量摆动指标)、WILLR (威廉指标) ### 波动率指标 - **布林带**: BOLL (布林带) - **真实波幅**: ATR (平均真实波幅) - **抛物线**: SAR (抛物线转向) ### 成交量指标 - **成交量**: OBV (能量潮)、AD (累积/派发线)、ADOSC (累积/派发振荡器) ### 其他指标 - **随机指标**: STOCH (随机振荡器) - **阿隆指标**: AROON (阿隆指标)、AROONOSC (阿隆振荡器) - **平衡动能**: BOP (平衡动能) - **趋向指标**: MINUS_DI、MINUS_DM、PLUS_DI、PLUS_DM - **时间序列**: TSF (时间序列预测)