Skip to main content
Glama

Stock MCP Server

by huweihua123
GitHub
Python
13
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

📈 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

🙏 致谢

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

MCP • FastAPI • AKShare • Tushare • yFinance • Tavily

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

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

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. 🙏 致谢

            New MCP Servers

            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