Ashareport

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 3, 2026

A-share stock data: history, realtime, news, statements and metrics.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

Ashareport's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Ashareport in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ashareport

ashareport exposes nine A-share (China mainland) stock-data tools — history, realtime quotes, news, balance sheet, income statement, cash flow, inner trades, and financial metrics, plus a local time tool — as a command line program and as a stdio MCP server.

How the data tools work (read this first)

The original design runs a Python market-data library in-process. This TypeScript rebuild uses an endpoint executor instead: set

bash
export ASHAREPORT_API_URL="https://your-data-endpoint.example"

and each data tool POSTs JSON {tool, source, params} to {ASHAREPORT_API_URL}/<tool> and returns the endpoint's JSON answer. With the variable unset, data tools return an error: upstream data endpoint not configured: set ASHAREPORT_API_URL .... get_time_info is fully local and needs no endpoint.

Source fallback is implemented locally, in the documented order:

DomainSource order
historicaleastmoney → eastmoney_direct → sina → ths
realtimeeastmoney_direct → eastmoney → xueqiu → ths (xueqiu/ths skipped when no symbol is given)
newseastmoney → ths
statements / metricssina → eastmoney_direct

The requested source is tried first, then the domain order when fallback is not false, stopping at the first non-empty result. If every source fails, the error lists each source and its error. Defaults: interval day, adjust none, recent_n 100 for historical data and 10 for the other recent-N tools.

indicators_list is passed through to the endpoint, not computed locally. get_time_info walks back from today skipping Saturday and Sunday to find the last trading day; exchange holidays are not modelled.

Install

bash
npx @reneturcios/ashareport get_time_infodocker run -i ghcr.io/cloudcorprecords/ashareport   # MCP server

CLI

bash
ashareport get_hist_data --symbol 600519 --interval day --recent-n 20ashareport get_realtime_data --symbol 600519ashareport get_realtime_data            # market-wide, symbol optionalashareport get_news_data --symbol 600519ashareport get_balance_sheet --symbol 600519ashareport get_income_statement --symbol 600519ashareport get_cash_flow --symbol 600519ashareport get_inner_trade_data --symbol 600519ashareport get_financial_metrics --symbol 600519ashareport get_time_infoashareport --version

Exit codes: 0 success, 1 tool error, 2 usage error.

MCP server

bash
npx -y @reneturcios/ashareport mcp
json
{  "mcpServers": {    "ashareport": {      "command": "npx",      "args": ["-y", "@reneturcios/ashareport", "mcp"],      "env": { "ASHAREPORT_API_URL": "https://your-data-endpoint.example" }    }  }}

Tools

ToolRequiredOther parameters
get_hist_datasymbolinterval, interval_multiplier, start_date, end_date, adjust, source, fallback, indicators_list, recent_n
get_realtime_data— (symbol optional)source, fallback
get_news_datasymbolsource, fallback, recent_n
get_balance_sheetsymbolsource, fallback, recent_n
get_income_statementsymbolsource, fallback, recent_n
get_cash_flowsymbolsource, fallback, recent_n
get_inner_trade_datasymbol—
get_financial_metricssymbolsource, fallback, recent_n
get_time_info—— (local: ISO time, Unix timestamp, last trading day)

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner, fake-fetch only, no networknpm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Source: README.md at commit d7a1ea8

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts