Skip to main content
Glama

Stock MCP Server

by huweihua123

📈 Stock MCP Server

基于 Model Context Protocol 的智能股票数据服务
一站式获取 A股/港股/美股实时数据 + AI 驱动的深度分析

Python Docker License

快速开始功能特性API 文档配置指南


✨ 为什么选择 Stock MCP?

  • 🌐 全球市场覆盖 - 一键接入 A股、港股、美股数据

  • 🤖 AI 智能分析 - 新闻情绪分析、深度研究报告、智能搜索

  • 🚀 开箱即用 - Docker 一键部署,5分钟启动服务

  • 📊 多数据源融合 - AKShare、Tushare、yFinance、Finnhub 智能聚合

  • 💾 高性能缓存 - Redis 加速 + 自动降级,稳定可靠


🚀 快速开始

# 1. 克隆项目 git clone <your-repo-url> && cd stock-mcp # 2. 配置环境变量(必需:TUSHARE_TOKEN) cp .env.example .env && vim .env # 3. 一键启动 docker-compose up -d # 4. 访问服务 open http://localhost:9998/docs

🎯 5分钟体验核心功能:

# 查询茅台股价 curl "http://localhost:9998/api/quote?symbol=600519" # 分析特斯拉新闻情绪 curl "http://localhost:9998/api/news/sentiment?symbol=TSLA&days=7" # AI 研究电动汽车行业 curl -X POST "http://localhost:9998/api/research" \ -d '{"topic":"电动汽车行业趋势"}'

🎯 核心功能

📊 数据查询

  • 实时行情 - 分钟级价格/成交量

  • 历史数据 - K线图、复权价格

  • 财务报表 - 资产负债表、现金流

  • 技术指标 - MACD、RSI、布林带

  • 资金流向 - 主力资金、北向资金

🤖 AI 增强

  • 🔍 智能搜索 - Tavily 语义搜索

  • 📰 情绪分析 - 多源新闻聚合 + 评分

  • 📈 深度研究 - AI 生成研究报告

  • 💡 决策辅助 - 数据驱动的投资建议

  • 🌐 多语言支持 - 中英文自动识别


⚙️ 配置说明

核心配置(.env 文件)

# 【必填】A股数据访问(申请地址:https://tushare.pro/) TUSHARE_TOKEN=your_token_here # 【可选】代理配置(访问美股数据时推荐) HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 # 【可选】增强功能 TAVILY_API_KEY=your_key # AI 搜索和研究 FINNHUB_API_KEY=your_key # 增强新闻数据 NEWS_API_KEY=your_key # 新闻聚合

配置项

说明

默认值

REDIS_HOST

Redis 主机

redis

(Docker)/

localhost

CACHE_ENABLED

是否启用缓存

true

CACHE_TTL

缓存过期时间(秒)

3600

详见:配置指南


📡 API 使用

核心接口示例

# 股票行情(支持 A股/美股/港股) GET /api/quote?symbol=600519&market=CN # 财务数据 GET /api/financial?symbol=AAPL&report_type=income # 新闻情绪(返回情绪评分 -1~1) GET /api/news/sentiment?symbol=TSLA&days=7 # AI 深度研究 POST /api/research { "topic": "新能源汽车行业分析", "depth": "comprehensive" }

📚 完整接口文档:启动服务后访问 http://localhost:9998/docs


🐳 Docker 部署

服务架构

端口

服务

说明

9998

FastAPI

RESTful API + Swagger 文档

9999

MCP Server

Model Context Protocol 服务

6379

Redis

内部缓存(不对外暴露)

常用命令

# 启动服务 docker-compose up -d # 查看日志 docker-compose logs -f stock-mcp # 停止服务 docker-compose down # 重启服务 docker-compose restart # 重新构建 docker-compose up -d --build

🛠️ 故障排查

# 检查配置 cat .env | grep REDIS_HOST # 确保 Docker 环境使用: REDIS_HOST=redis # 检查 Redis 状态 docker-compose ps redis
# 检查代理配置 cat .env | grep PROXY # Docker 环境应使用: HTTP_PROXY=http://host.docker.internal:7890

确保 Token 有效且已配置到 .env 文件:

grep TUSHARE_TOKEN .env

更多问题完整故障排查指南


📚 文档


🤝 参与贡献

欢迎提交 Issue 和 Pull Request!

# 1. Fork 项目 # 2. 创建特性分支 git checkout -b feature/amazing-feature # 3. 提交代码 git commit -m "Add: amazing feature" # 4. 推送并创建 PR git push origin feature/amazing-feature

📄 开源协议

MIT License - 详见 LICENSE


🙏 致谢

本项目基于以下优秀开源项目构建

MCPFastAPIAKShareTushareyFinanceTavily


⭐️ 如果对你有帮助,请给个 Star ⭐️

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides real-time stock data and AI-powered analysis for A-shares, Hong Kong stocks, and US stocks. Features sentiment analysis of financial news, deep research reports, and comprehensive market data through multiple integrated data sources.

  1. ✨ 为什么选择 Stock MCP?
    1. 🚀 快速开始
      1. 🎯 核心功能
        1. 📊 数据查询
        2. 🤖 AI 增强
      2. ⚙️ 配置说明
        1. 核心配置(.env 文件)
      3. 📡 API 使用
        1. 核心接口示例
      4. 🐳 Docker 部署
        1. 服务架构
        2. 常用命令
      5. 🛠️ 故障排查
        1. 📚 文档
          1. 🤝 参与贡献
            1. 📄 开源协议
              1. 🙏 致谢

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/huweihua123/stock-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server