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：

1. 注册 Tushare Pro 账号
2. 获取 API Token

🔧 在 MCP 服务器中添加

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

其他 MCP 客户端

对于其他支持 MCP 协议的客户端，可以直接运行：

python -m smart_finacial_mcp.server

或使用入口点：

smart-finacial-mcp

📚 MCP 工具完整指南

📊 支持的数据类型

指数代码示例：

• 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 积分制度的访问控制

🤝 贡献指南

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

开发环境

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

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

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

📄 开源协议

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

🙏 致谢

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

📞 联系方式

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

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

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