Akshare One MCP

🚀 基於 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);