🚀 基于 akshare-one 的 MCP 服务器

本项目是基于 akshare-one 的 MCP 服务器，为用户提供中国股市数据接口。它提供了一系列获取金融信息的工具，涵盖历史股票数据、实时数据、新闻数据、财务报表等内容，助力用户高效获取股市相关信息。

✨ 主要特性

本服务器提供了多种实用工具，用于获取各类股市数据，以下是各工具的详细介绍：

get_hist_data

• 功能：获取历史股票数据。
• 输入参数：
  • symbol (字符串)：股票代码。
  • interval (字符串)：时间间隔，可选值为 'minute'、'hour'、'day'、'week'、'month'、'year'。
  • interval_multiplier (数字，可选)：间隔倍数，默认值为 1。
  • start_date (字符串，可选)：起始日期，格式为 YYYY - MM - DD，默认值为 '1970 - 01 - 01'。
  • end_date (字符串，可选)：结束日期，格式为 YYYY - MM - DD，默认值为 '2030 - 12 - 31'。
  • adjust (字符串，可选)：调整类型，可选值为 'none'、'qfq'、'hfq'，默认值为 'none'。
  • source (字符串，可选)：数据源，可选值为 'eastmoney'、'sina'，默认值为 'eastmoney'。

get_realtime_data

• 功能：获取实时股票数据。
• 输入参数：
  • symbol (字符串，可选)：股票代码。
  • source (字符串，可选)：数据源，默认值为 'eastmoney'。

get_news_data

• 功能：获取与股票相关的新闻数据。
• 输入参数：
  • symbol (字符串)：股票代码。
  • source (字符串，可选)：数据源，默认值为 'eastmoney'。

get_balance_sheet

• 功能：获取公司资产负债表数据。
• 输入参数：
  • symbol (字符串)：股票代码。
  • source (字符串，可选)：数据源，默认值为 'sina'。

get_income_statement

• 功能：获取公司收益表数据。
• 输入参数：
  • symbol (字符串)：股票代码。
  • source (字符串，可选)：数据源，默认值为 'sina'。

get_cash_flow

• 功能：获取公司现金流表数据。
• 输入参数：
  • symbol (字符串)：股票代码。
  • source (字符串，可选)：数据源，默认值为 'sina'。

get_inner_trade_data

• 功能：获取公司内部交易数据。
• 输入参数：
  • symbol (字符串，可选)：股票代码。
  • source (字符串，可选)：数据源，默认值为 'xueqiu'。

📦 安装指南

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 akshare - one - mcp，可执行以下命令：

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

手动安装准备工作

1. 克隆此仓库：

git clone https://github.com/zwldarren/akshare-one-mcp.git
cd akshare-one-mcp

2. 若尚未安装，请安装 uv。
3. 安装依赖项：

uv sync

💻 使用示例

连接到任意 MCP 客户端

将以下配置添加到 MCP 服务器配置文件中：

{
  "configuration": {
    "akshare_one_mcp_server": {
      "host": "localhost",
      "port": 3000
    }
  }
}

在代码中使用：

const { akshareOneMCPClient } = require('@zwldarren/akshare-one-mcp-client');
async function main() {
  const client = new akshareOneMCPClient({
    configuration: {
      akshare_one_mcp_server: {
        host: 'localhost',
        port: 3000
      }
    }
  });
  // 使用工具进行操作，例如：
  await client.getHistData({ symbol: 'AAPL' });
}
main().catch(console.error);