zwldarren/akshare-one-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

240 stars 53 forks Качество 82 Тренд 38MIT

zwldarren/akshare-one-mcp — это кандидат на сервер MCP, импортированный из https://github.com/zwldarren/akshare-one-mcp.

Обзор

zwldarren/akshare-one-mcp — это кандидат на сервер MCP, импортированный из https://github.com/zwldarren/akshare-one-mcp.

Обзор (машинный перевод)

Английский | 中文

Обзор

MCP-сервер на базе akshare-one, предоставляющий комплексные интерфейсы для данных о фондовом рынке Китая. Он предлагает набор мощных инструментов для получения финансовой информации, включая исторические данные по акциям, данные в реальном времени, новости и финансовые отчёты.

Доступные инструменты

Автоматический запасной вариант источника

За исключением get_news_data и get_inner_trade_data, у которых вверх по потоку открывает один источник, каждый инструмент принимает параметр source для предпочтительного источника данных и параметр fallback (включенный по умолчанию), который решает, будут ли другие источники того же домена, когда этот источник повышает или возвращает пустой кадр:

Домен	Порядок попыток
Исторические	`eastmoney` → `eastmoney_direct` → `sina`
В реальном времени	`eastmoney_direct` → `eastmoney` → `xueqiu` (пропускается, когда символ не указан)
Финансовая отчетность	`sina` ⇄ `eastmoney_direct`

Запрашиваемый source всегда пробуют первым; порядок определяет только запасной вариант. Поскольку akshare-one проецирует все источники на заявленные столбцы своего домена, возврат не может изменить имена полей или их порядок.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

AKShare One MCP Server

Overview

An MCP server based on akshare-one, providing comprehensive interfaces for China stock market data. It offers a set of powerful tools for retrieving financial information including historical stock data, real-time data, news data, and financial statements.

Available Tools

Automatic source fallback

Except for get_inner_trade_data, whose upstream exposes a single source, every data tool takes a source parameter for the preferred data source and a fallback parameter (on by default) that decides whether the other sources of the same domain are tried when that source raises or returns an empty frame:

Domain	Order tried
Historical	`eastmoney` → `eastmoney_direct` → `sina` → `ths`
Real-time	`eastmoney_direct` → `eastmoney` → `xueqiu` → `ths` (the last two are skipped when no symbol is given)
News	`eastmoney` → `ths`
Financial statements	`sina` ⇄ `eastmoney_direct`

The requested source is always tried first; the order only governs the fallback. Because akshare-one projects every source onto its domain’s declared columns, falling back cannot change the field names or their order. When every source fails, the error lists each one and why it failed; when every source succeeds but has no data, an empty result is returned. Set fallback to false to pin a single source — a failure then surfaces directly, which is useful when you need to know exactly where the numbers came from.

The source that actually served a call is logged under the akshare_one_mcp.providers logger.

Market Data Tools

`get_hist_data`

Get historical stock market data with support for multiple time periods and adjustment methods.

symbol (string, required): Stock code (e.g. ‘000001’)
interval (string, optional): Time interval (‘minute’,‘hour’,‘day’,‘week’,‘month’,‘year’) (default: ‘day’)

Открыть полный README на GitHub

Установка

uvx akshare-one-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uvx",
      "args": ["akshare-one-mcp"]
    }
  }
}