Smart Finacial Mcp
@YUHAI0
Smart Financial MCP 是一个基于 Model Context Protocol 的金融数据 MCP 服务器，连接 Tushare Pro API，为投资研究、财务分析、行业分析从业者及 AI 助手用户提供便捷的股票数据查询能力。
Overview
What is Smart Financial MCP?
Smart Financial MCP is a Model Context Protocol (MCP) server that connects to the Tushare Pro API, enabling AI assistants (like Claude) to query real-time financial data through natural language conversation. It is designed for investors, financial analysts, and AI assistant users.
How to use Smart Financial MCP?
Install via uvx and configure the Tushare API token in your MCP client settings. The server is started automatically when used with a compatible MCP client; alternatively, run python -m smart_finacial_mcp.server or use the smart-finacial-mcp entry point.
Key features of Smart Financial MCP
- Provides real‑time A‑share, ETF, index, and futures market data.
- Offers token validation, stock search, and daily fundamentals.
- Generates financial analysis reports and structured tables.
- Uses local encrypted storage for the Tushare API token.
- Integrates with AI assistants via the Model Context Protocol.
Use cases of Smart Financial MCP
- Ask AI to check a stock’s basic information or search by keyword.
- Request daily price history or real‑time quotes for a single stock or ETF.
- Retrieve and analyze income statements, daily PE/PB, and other fundamentals.
- Monitor market‑wide limit‑up/down‑statistics and financial news.
- Get index points, futures settlement prices, and historical trends.
FAQ from Smart Financial MCP
What data sources does Smart Financial MCP use?
It uses the Tushare Pro API for all market data, including stocks, ETFs, indices, futures, and financial news.
What runtime dependencies are required?
Python 3.10 or higher is required, along with a valid Tushare Pro account and API token.
Where is the Tushare token stored?
The token is stored locally in the ~/.tushare_mcp/.env file and transmitted over HTTPS.
What are the main tools available?
Tools cover token status, stock info, daily/realtime prices, ETF/index/futures data, fundamentals, income statements, limit prices, and financial news.
Which transports/authentication does the server use?
The server implements MCP over stdio and authenticates via the TUSHARE_TOKEN environment variable. No additional authentication is built in.
