How do I install Smart Financial MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Smart Financial MCP safe to use with an AI agent?

Its trust score is 51 out of 100 (fair). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Smart Financial MCP still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.

About Smart Financial MCP

Smart Financial MCP is an MCP server published by YUHAI0 in the Developer Tools category: 基于 Model Context Protocol (MCP) 的智能股票数据助手，提供与 AI 助手自然对话获取股票数据的能力。.

The repository has 5 stars and 1 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source

git clone https://github.com/YUHAI0/smart-financial-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Smart Financial MCP

I know everything about Smart Financial MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.

✓README presentThe repository ships documentation.
✓License declaredUsable under a stated license.
!Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
✓Dependencies pinnedA lockfile pins dependency versions.
✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
!Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

Smart Financial MCP

基于 Model Context Protocol (MCP) 的智能股票数据助手，提供与 AI 助手自然对话获取股票数据的能力。

🎯 项目概述

Smart Financial MCP 是一个基于 Model Context Protocol 的金融数据 MCP 服务器，连接 Tushare Pro API，为投资研究、财务分析、行业分析从业者及 AI 助手用户提供便捷的股票数据查询能力。

核心特性

🤖 AI 助手集成：与 Claude 等 AI 助手无缝对话
📊 实时数据：连接 Tushare Pro API 获取实时金融数据
🔒 安全管理：本地加密存储 Tushare API Token
📈 多种数据：支持股票、ETF、指数、期货等多种金融产品
🎨 智能分析：自动生成财务分析报告和可视化表格

技术架构

graph TD
    subgraph "用户交互层"
        AI[AI助手<br/>如Claude]
    end
    subgraph "MCP服务层"
        MCP[MCP服务器]
        Prompt[提示模板]
    end
    subgraph "数据服务层"
        Server[server.py]
        Tushare[Tushare Pro API]
    end
    subgraph "安全与配置"
        Env[环境变量]
        Token[Token管理]
    end
    
    AI --> |自然语言查询| MCP
    MCP --> |调用工具函数| Server
    Server --> |API请求| Tushare
    Tushare --> |返回数据| Server
    Server --> |格式化结果| MCP
    MCP --> |自然语言响应| AI
    Env --> |安全存储| Token
    Token --> |验证| Server

🚀 快速开始

环境要求

Python 3.10 或更高版本
Tushare Pro 账号和 API Token

配置 Tushare Token

首次使用需要配置 Tushare Pro API Token：

注册 Tushare Pro 账号
获取 API Token
使用 AI 助手的 setup_tushare_token 工具进行配置

🔧 在 MCP 服务器中添加

{
  "mcpServers": {
    "smart-financial-mcp": {
      "command": "uvx",
      "args": ["smart-financial-mcp"],
      "env": {
        "TUSHARE_TOKEN": "your-tushare-token"
      }
    }
  }
}

📚 MCP 工具完整指南

工具名称	功能描述	主要参数	返回内容
Token 管理
`check_token_status`	检查 Tushare token 配置状态	无	Token 状态信息和配置指导
股票基础信息
`get_stock_basic_info`	获取股票基础信息	`ts_code`（股票代码）`name`（股票名称）	股票代码、名称、所属地区、行业、上市日期、市场类型等
`search_stocks`	智能搜索股票	`keyword`（必填，搜索关键词）	匹配的股票列表，支持模糊匹配代码和名称
行情数据
`get_daily_stock_price`	获取 A 股日线行情数据	`ts_code`（股票代码，支持多股票）`trade_date`（交易日期）`start_date`、`end_date`（日期范围）	开盘价、最高价、最低价、收盘价、涨跌额、涨跌幅、成交量、成交额、统计分析
`get_realtime_stock_price`	获取实时行情数据	`ts_code`（必填，支持通配符如 6*.SH）	实时价格、涨跌幅、成交信息、市场统计
`get_etf_daily_price`	获取 ETF 日线行情	`ts_code`（基金代码）`trade_date`（交易日期）`start_date`、`end_date`（日期范围）	ETF 价格走势、成交数据、市场统计
`get_index_daily_price`	获取指数日线行情	`ts_code`（必填，指数代码如 399300.SZ）`trade_date`（交易日期）`start_date`、`end_date`（日期范围）	指数点位、涨跌幅、成交量、成交额
`get_futures_daily_price`	获取期货日线行情	`trade_date`（交易日期）`ts_code`（合约代码）`exchange`（交易所代码）`start_date`、`end_date`（日期范围）	期货价格、结算价、持仓量、成交数据
基本面分析
`get_daily_basic_indicators`	获取每日基本面指标	`ts_code`（股票代码）`trade_date`（交易日期）`start_date`、`end_date`（日期范围）	PE、PB、PS、股息率、换手率、量比、总股本、流通股本、市值数据
`get_income_statement`	获取利润表数据并生成智能分析	`ts_code`（必填，股票代码）`start_date`、`end_date`（日期范围）`report_type`（报告类型，默认合并报表）	财务数据表格、收入分析、盈利能力分析、成本费用分析、每股指标分析
市场数据
`get_stock_limit_prices`	获取涨跌停价格数据	`ts_code`（股票代码）`trade_date`（交易日期）`start_date`、`end_date`（日期范围）	涨停价、跌停价、全市场涨跌停统计、价格区间分析
`get_financial_news`	获取财经快讯新闻	`src`（必填，新闻来源）`start_date`、`end_date`（必填，时间范围）	新闻列表、时间分布统计、热门关键词提取
提示模板
`income_statement_query`	利润表查询引导模板	无	利润表查询的详细指导和示例

📊 支持的数据类型

指数代码示例：

399300.SZ：沪深300
000001.SH：上证指数
399001.SZ：深证成指
399006.SZ：创业板指
000905.SH：中证500

期货交易所：

SHF：上海期货交易所
DCE：大连商品交易所
CZE：郑州商品交易所
INE：上海国际能源交易中心

新闻来源：

sina：新浪财经
wallstreetcn：华尔街见闻
10jqka：同花顺
eastmoney：东方财富
cls：财联社
yicai：第一财经

💡 使用示例

基础查询

"查询平安银行的基本信息"
"搜索包含新能源的股票"
"获取贵州茅台最近一个月的股价"

深度分析

"分析平安银行2023年的利润表"
"查询沪深300指数最近一周的走势"
"获取今日涨停股票统计"

市场监控

"获取今日财联社快讯"
"查询创业板ETF的实时行情"
"分析中证500的每日基本面指标"

🔒 数据安全

本地存储：Token 存储在本地 ~/.tushare_mcp/.env 文件
加密传输：所有 API 调用使用 HTTPS 加密
权限控制：基于 Tushare Pro 积分制度的访问控制

🤝 贡献指南

Fork 本仓库
创建特性分支：git checkout -b feature/AmazingFeature
提交更改：git commit -m 'Add some AmazingFeature'
推送到分支：git push origin feature/AmazingFeature
开启 Pull Request

开发环境

# 克隆仓库
git clone https://github.com/YUHAI0/smart-financial-mcp.git
cd smart-financial-mcp

# 安装开发依赖
pip install -e ".[dev]"

# 运行代码质量检查
black smart_financial_mcp/
isort smart_financial_mcp/
flake8 smart_financial_mcp/
mypy smart_financial_mcp/

📄 开源协议

本项目采用 MIT 协议开源 - 查看 LICENSE 文件了解详情。

🙏 致谢

Tushare Pro - 提供专业的金融数据 API
Model Context Protocol - 提供 AI 助手集成框架
FastMCP - 提供高效的 MCP 服务器实现

📞 联系方式

作者：yuhai
邮箱：me.yuhai@hotmail.com
项目地址：https://github.com/YUHAI0/smart-financial-mcp
问题反馈：https://github.com/YUHAI0/smart-financial-mcp/issues

⭐ 如果这个项目对你有帮助，请给它一个星标！

🚀 开始使用 Smart Financial MCP，让 AI 助手成为你的专业金融数据分析师！

Read full README

README fetched from the repository 6 days ago. The original is authoritative.

About Smart Financial MCP

Install

Ask AI

Security checks

README

Smart Financial MCP

🎯 项目概述

核心特性

技术架构

🚀 快速开始

环境要求

配置 Tushare Token

🔧 在 MCP 服务器中添加

📚 MCP 工具完整指南

📊 支持的数据类型

💡 使用示例

基础查询

深度分析

市场监控

🔒 数据安全

🤝 贡献指南

开发环境

📄 开源协议

🙏 致谢

📞 联系方式

Alternatives to Smart Financial MCP

Gemini CLI

oraios/serena

For Beginners

Skill Seekers

Nginx UI

Xiaozhi Esp32 Server

About Smart Financial MCP