FinanceMCP-DCTHS

FinanceMCP-DCTHS is a connection-permissioned MCP server that exposes two data sources, THS (TongHuaShun) and DC (DongCai), through a unified MCP interface. It lets you query sector indices, sector constituents, and sector daily data from both THS and DC sources, with deploy options for local use or server deployment. It’s designed for rapid experimentation, testing, and production-like access to financial sector data via MCP calls.

How to use

You interact with FinanceMCP-DCTHS from an MCP client. The server provides six core tools to fetch sector-related data from THS and DC sources. You can run the stdio (local) version for quick testing or deploy the HTTP (server) version for multi-user access. Use the relevant MCP calls to request the data you need, such as THS sector indices, THS sector daily data, THS sector constituents, and the DC equivalents.

Practical usage patterns include starting the local stdio server for quick experiments, or starting the HTTP server to expose an API endpoint at a stable URL. When you call specific tools, you reference the function names provided by the server, such as get_ths_index, get_ths_daily, get_ths_member, get_dc_index, get_dc_member, and get_dc_daily, with the appropriate parameters you see in the parameter table.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system. You will either run the server directly with npx for a quick start or build and run the HTTP server for production-like deployment.

1. Direct start (recommended for quick testing) supports running without installation steps.

2. Build from source and run the HTTP server for deployment. Follow the concrete sequence below.

Additional sections

Configuration and deployment options are provided for both stdio and HTTP modes. You will supply your Tushare token to access the data sources. For local testing, set the token via environment variables and, for HTTP deployments, pass tokens through HTTP headers.

Security guidance: store tokens securely, prefer environment variables or secret management in production, and avoid hard-coding tokens in source or client configurations.

Troubleshooting: common issues include missing Tushare tokens, insufficient permissions for certain data endpoints, or date/stock-concept codes that do not have data on the requested dates.

Notes: this server integrates THS and DC data sources via MCP endpoints and supports both local testing and production-style deployments. The six core tools provide access to sector indices, sector daily data, and sector constituents for both THS and DC sources.

Available tools

get_ths_index

Fetches the list of TongHuaShun sector indices, with optional filters by ts_code, exchange, and type.

get_ths_daily

Fetches daily sector data for TongHuaShun sectors, including prices and volumes, with optional date range filters.

get_ths_member

Fetches the component stocks for a TongHuaShun sector, or queries which sector a stock belongs to.

get_dc_index

Fetches DC sector information for given names, codes, or trade dates including leading stocks and market cap.

get_dc_member

Fetches DC sector constituents and supports historical constituency queries.

get_dc_daily

Fetches daily DC sector data for specified sector types and date ranges.