金大哥 - akshare-one-mcp MCP 详情

article

README

🚀 基于 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

手动安装准备工作

克隆此仓库：

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

若尚未安装 uv，请先进行安装。
安装依赖项：

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);

akshare-one-mcp