[{"_1":2,"_349":-5,"_350":-5},"loaderData",{"_3":4,"_22":23,"_261":262},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",21617481,"membership","referenceId","019a2dfc-1dad-704d-a3b8-88a103e988d5","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_177":178,"_260":163},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","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.","name","Stock MCP Server","readme","

\n\n# 📈 Stock MCP Server\n\n> **基于 Model Context Protocol 的智能股票数据服务** \n> 一站式获取 A股/港股/美股实时数据 + AI 驱动的深度分析\n\n[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](https://www.docker.com/)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n[快速开始](#-快速开始) • [功能特性](#-核心功能) • [API 文档](http://localhost:9998/docs) • [配置指南](docs/GUIDE.md)\n\n

\n\n---\n\n## ✨ 为什么选择 Stock MCP？\n\n- 🌐 **全球市场覆盖** - 一键接入 A股、港股、美股数据\n- 🤖 **AI 智能分析** - 新闻情绪分析、深度研究报告、智能搜索\n- 🚀 **开箱即用** - Docker 一键部署，5分钟启动服务\n- 📊 **多数据源融合** - AKShare、Tushare、yFinance、Finnhub 智能聚合\n- 💾 **高性能缓存** - Redis 加速 + 自动降级，稳定可靠\n\n---\n\n## 🚀 快速开始\n\n```bash\n# 1. 克隆项目\ngit clone && cd stock-mcp\n\n# 2. 配置环境变量（必需：TUSHARE_TOKEN）\ncp .env.example .env && vim .env\n\n# 3. 一键启动\ndocker-compose up -d\n\n# 4. 访问服务\nopen http://localhost:9998/docs\n```\n\n**🎯 5分钟体验核心功能：**\n```bash\n# 查询茅台股价\ncurl \"http://localhost:9998/api/quote?symbol=600519\"\n\n# 分析特斯拉新闻情绪\ncurl \"http://localhost:9998/api/news/sentiment?symbol=TSLA&days=7\"\n\n# AI 研究电动汽车行业\ncurl -X POST \"http://localhost:9998/api/research\" \\\n -d '{\"topic\":\"电动汽车行业趋势\"}'\n```\n\n---\n\n## 🎯 核心功能\n\n\n\n\n\n\n

\n\n### 📊 数据查询\n- ✅ **实时行情** - 分钟级价格/成交量\n- ✅ **历史数据** - K线图、复权价格\n- ✅ **财务报表** - 资产负债表、现金流\n- ✅ **技术指标** - MACD、RSI、布林带\n- ✅ **资金流向** - 主力资金、北向资金\n\n

\n\n### 🤖 AI 增强\n- 🔍 **智能搜索** - Tavily 语义搜索\n- 📰 **情绪分析** - 多源新闻聚合 + 评分\n- 📈 **深度研究** - AI 生成研究报告\n- 💡 **决策辅助** - 数据驱动的投资建议\n- 🌐 **多语言支持** - 中英文自动识别\n\n

\n\n---\n\n## ⚙️ 配置说明\n\n### 核心配置（`.env` 文件）\n\n```bash\n# 【必填】A股数据访问（申请地址：https://tushare.pro/）\nTUSHARE_TOKEN=your_token_here\n\n# 【可选】代理配置（访问美股数据时推荐）\nHTTP_PROXY=http://127.0.0.1:7890\nHTTPS_PROXY=http://127.0.0.1:7890\n\n# 【可选】增强功能\nTAVILY_API_KEY=your_key # AI 搜索和研究\nFINNHUB_API_KEY=your_key # 增强新闻数据\nNEWS_API_KEY=your_key # 新闻聚合\n```\n\n

📖 完整配置说明

\n\n| 配置项 | 说明 | 默认值 |\n| --------------- | ------------------ | ------------------------------ |\n| `REDIS_HOST` | Redis 主机 | `redis`（Docker）/ `localhost` |\n| `CACHE_ENABLED` | 是否启用缓存 | `true` |\n| `CACHE_TTL` | 缓存过期时间（秒） | `3600` |\n\n详见：[配置指南](docs/GUIDE.md#配置详解)\n

\n\n---\n\n## 📡 API 使用\n\n### 核心接口示例\n\n```bash\n# 股票行情（支持 A股/美股/港股）\nGET /api/quote?symbol=600519&market=CN\n\n# 财务数据\nGET /api/financial?symbol=AAPL&report_type=income\n\n# 新闻情绪（返回情绪评分 -1~1）\nGET /api/news/sentiment?symbol=TSLA&days=7\n\n# AI 深度研究\nPOST /api/research\n{\n \"topic\": \"新能源汽车行业分析\",\n \"depth\": \"comprehensive\"\n}\n```\n\n**📚 完整接口文档**：启动服务后访问 http://localhost:9998/docs\n\n---\n\n## 🐳 Docker 部署\n\n### 服务架构\n\n| 端口 | 服务 | 说明 |\n| ------ | ---------- | --------------------------- |\n| `9998` | FastAPI | RESTful API + Swagger 文档 |\n| `9999` | MCP Server | Model Context Protocol 服务 |\n| `6379` | Redis | 内部缓存（不对外暴露） |\n\n### 常用命令\n\n```bash\n# 启动服务\ndocker-compose up -d\n\n# 查看日志\ndocker-compose logs -f stock-mcp\n\n# 停止服务\ndocker-compose down\n\n# 重启服务\ndocker-compose restart\n\n# 重新构建\ndocker-compose up -d --build\n```\n\n---\n\n## 🛠️ 故障排查\n\n

❌ Redis 连接失败

\n\n```bash\n# 检查配置\ncat .env | grep REDIS_HOST\n# 确保 Docker 环境使用: REDIS_HOST=redis\n\n# 检查 Redis 状态\ndocker-compose ps redis\n```\n

\n\n

❌ yFinance 超时

\n\n```bash\n# 检查代理配置\ncat .env | grep PROXY\n# Docker 环境应使用: HTTP_PROXY=http://host.docker.internal:7890\n```\n

\n\n

❌ Tushare 权限错误

\n\n确保 Token 有效且已配置到 `.env` 文件：\n```bash\ngrep TUSHARE_TOKEN .env\n```\n

\n\n**更多问题**：[完整故障排查指南](docs/GUIDE.md#故障排查)\n\n---\n\n## 📚 文档\n\n- [📖 完整使用指南](docs/GUIDE.md) - 配置、部署、API 详解\n- [🔧 开发文档](docs/DEVELOPMENT.md) - 架构设计、二次开发\n\n---\n\n## 🤝 参与贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n```bash\n# 1. Fork 项目\n# 2. 创建特性分支\ngit checkout -b feature/amazing-feature\n\n# 3. 提交代码\ngit commit -m \"Add: amazing feature\"\n\n# 4. 推送并创建 PR\ngit push origin feature/amazing-feature\n```\n\n---\n\n## 📄 开源协议\n\nMIT License - 详见 [LICENSE](LICENSE)\n\n---\n\n

\n\n### 🙏 致谢\n\n本项目基于以下优秀开源项目构建\n\n[MCP](https://modelcontextprotocol.io/) • [FastAPI](https://fastapi.tiangolo.com/) • [AKShare](https://akshare.akfamily.xyz/) • [Tushare](https://tushare.pro/) • [yFinance](https://github.com/ranaroussi/yfinance) • [Tavily](https://tavily.com/)\n\n---\n\n**⭐️ 如果对你有帮助，请给个 Star ⭐️**\n\n

\n","English","tag","en-US",{"_41":42,"_13":43,"_50":32,"_51":32,"_16":52,"_53":54,"_33":34,"_87":88,"_95":-5,"_96":-5,"_97":98,"_166":167,"_171":-5,"_61":153,"_172":173,"_64":174,"_175":176},"addedAt","2025-10-08T07:03:51.940700Z",[44,45,46,47,48,49],"category:finance","category:search","category:research-and-data","environment:network","hosting:remote-capable","language:python","descriptionMarkdown","descriptionPlainText",12358,"integrations",[55,66,73,80],{"_56":57,"_31":63,"_64":65},"brand",{"_58":59,"_33":60,"_61":62},"logoSvgPath","M13.983 11.078h2.119a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.119a.185.185 0 00-.185.185v1.888c0 .102.083.185.185.185m-2.954-5.43h2.118a.186.186 0 00.186-.186V3.574a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m0 2.716h2.118a.187.187 0 00.186-.186V6.29a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.887c0 .102.082.185.185.186m-2.93 0h2.12a.186.186 0 00.184-.186V6.29a.185.185 0 00-.185-.185H8.1a.185.185 0 00-.185.185v1.887c0 .102.083.185.185.186m-2.964 0h2.119a.186.186 0 00.185-.186V6.29a.185.185 0 00-.185-.185H5.136a.186.186 0 00-.186.185v1.887c0 .102.084.185.186.186m5.893 2.715h2.118a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m-2.93 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.083.185.185.185m-2.964 0h2.119a.185.185 0 00.185-.185V9.006a.185.185 0 00-.184-.186h-2.12a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185m-2.92 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.082.185.185.185M23.763 9.89c-.065-.051-.672-.51-1.954-.51-.338.001-.676.03-1.01.087-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199-.226.327c-.284.438-.49.922-.612 1.43-.23.97-.09 1.882.403 2.661-.595.332-1.55.413-1.744.42H.751a.751.751 0 00-.75.748 11.376 11.376 0 00.692 4.062c.545 1.428 1.355 2.48 2.41 3.124 1.18.723 3.1 1.137 5.275 1.137.983.003 1.963-.086 2.93-.266a12.248 12.248 0 003.823-1.389c.98-.567 1.86-1.288 2.61-2.136 1.252-1.418 1.998-2.997 2.553-4.4h.221c1.372 0 2.215-.549 2.68-1.009.309-.293.55-.65.707-1.046l.098-.288Z","Docker","slug","docker","Supports Docker deployment with container orchestration for the stock data service, including Redis caching layer","uid","26hkf0dy5j",{"_56":67,"_31":71,"_64":72},{"_58":68,"_33":69,"_61":70},"M12 .0387C5.3729.0384.0003 5.3931 0 11.9988c-.001 6.6066 5.372 11.9628 12 11.9625 6.628.0003 12.001-5.3559 12-11.9625-.0003-6.6057-5.3729-11.9604-12-11.96m-.829 5.4153h7.55l-7.5805 5.3284h5.1828L5.279 18.5436q2.9466-6.5444 5.892-13.0896","FastAPI","fastapi","Provides RESTful API endpoints for stock data queries, financial analysis, and AI-powered research through FastAPI framework","x9p9luheu3",{"_56":74,"_31":78,"_64":79},{"_58":75,"_33":76,"_61":77},"M22.71 13.145c-1.66 2.092-3.452 4.483-7.038 4.483-3.203 0-4.397-2.825-4.48-5.12.701 1.484 2.073 2.685 4.214 2.63 4.117-.133 6.94-3.852 6.94-7.239 0-4.05-3.022-6.972-8.268-6.972-3.752 0-8.4 1.428-11.455 3.685C2.59 6.937 3.885 9.958 4.35 9.626c2.648-1.904 4.748-3.13 6.784-3.744C8.12 9.244.886 17.05 0 18.425c.1 1.261 1.66 4.648 2.424 4.648.232 0 .431-.133.664-.365a100.49 100.49 0 0 0 5.54-6.765c.222 3.104 1.748 6.898 6.014 6.898 3.819 0 7.604-2.756 9.33-8.965.2-.764-.73-1.361-1.261-.73zm-4.349-5.013c0 1.959-1.926 2.922-3.685 2.922-.941 0-1.664-.247-2.235-.568 1.051-1.592 2.092-3.225 3.21-4.973 1.972.334 2.71 1.43 2.71 2.619z","Redis","redis","Enables high-performance caching of stock market data with automatic fallback mechanisms for improved reliability and speed","x9p2dukop6",{"_56":81,"_31":85,"_64":86},{"_58":82,"_33":83,"_61":84},"M12 0C5.383 0 0 5.383 0 12s5.383 12 12 12c6.616 0 12-5.383 12-12S18.616 0 12 0zm0 1.144c5.995 0 10.856 4.86 10.856 10.856 0 5.995-4.86 10.856-10.856 10.856-5.996 0-10.856-4.86-10.856-10.856C1.144 6.004 6.004 1.144 12 1.144zM8.37 5.868a6.707 6.707 0 0 0-.423.005c-.983.056-1.573.517-1.735 1.472-.115.665-.096 1.348-.143 2.017-.013.35-.05.697-.115 1.038-.134.609-.397.798-1.016.83a2.65 2.65 0 0 0-.244.042v1.463c1.126.055 1.278.452 1.37 1.629.033.429-.013.858.015 1.287.018.406.073.808.156 1.2.259 1.075 1.307 1.435 2.575 1.218v-1.283c-.203 0-.383.005-.558 0-.43-.013-.591-.12-.632-.535-.056-.535-.042-1.08-.075-1.62-.064-1.001-.175-1.988-1.153-2.625.503-.37.868-.812.983-1.398.083-.41.134-.821.166-1.237.028-.415-.023-.84.014-1.25.06-.665.102-.937.9-.91.12 0 .235-.017.369-.027v-1.31c-.16 0-.31-.004-.454-.006zm7.593.009a4.247 4.247 0 0 0-.813.06v1.274c.245 0 .434 0 .623.005.328.004.577.13.61.494.032.332.031.669.064 1.006.065.669.101 1.347.217 2.007.102.544.475.95.941 1.283-.817.549-1.057 1.333-1.098 2.215-.023.604-.037 1.213-.069 1.822-.028.554-.222.734-.78.748-.157.004-.31.018-.484.028v1.305c.327 0 .627.019.927 0 .932-.055 1.495-.507 1.68-1.412.078-.498.124-1 .138-1.504.032-.461.028-.927.074-1.384.069-.715.397-1.01 1.112-1.057a.972.972 0 0 0 .199-.046v-1.463c-.12-.014-.204-.027-.291-.032-.536-.023-.804-.203-.937-.71a5.146 5.146 0 0 1-.152-.993c-.037-.618-.033-1.241-.074-1.86-.08-1.192-.794-1.753-1.887-1.786zm-6.89 5.28a.844.844 0 0 0-.083 1.684h.055a.83.83 0 0 0 .877-.78v-.046a.845.845 0 0 0-.83-.858zm2.911 0a.808.808 0 0 0-.834.78c0 .027 0 .05.004.078 0 .503.342.826.859.826.507 0 .826-.332.826-.853-.005-.503-.342-.836-.855-.831zm2.963 0a.861.861 0 0 0-.876.835c0 .47.378.849.849.849h.009c.425.074.853-.337.881-.83.023-.457-.392-.854-.863-.854z","Swagger","swagger","Offers interactive API documentation and testing interface for all stock market data endpoints","9emwagbk32","namespace",{"_89":90,"_61":94},"owner",{"_91":92},"githubAccount",{"_93":94},"login","huweihua123","readmeMarkdown","redditPostExternalId","repository",{"_99":100,"_138":139,"_142":143,"_161":-5,"_162":163,"_164":-5,"_165":-5},"argumentsJsonSchema",{"_101":102,"_135":136,"_108":137},"properties",{"_103":104,"_110":111,"_113":114,"_116":117,"_119":120,"_122":123,"_126":127,"_129":130,"_132":133},"CACHE_TTL",{"_105":106,"_31":107,"_108":109},"default","3600","Cache expiration time in seconds","type","string","HTTP_PROXY",{"_31":112,"_108":109},"HTTP proxy configuration (recommended for US stock data access)","REDIS_HOST",{"_105":77,"_31":115,"_108":109},"Redis host (default: redis for Docker, localhost for local)","HTTPS_PROXY",{"_31":118,"_108":109},"HTTPS proxy configuration (recommended for US stock data access)","NEWS_API_KEY",{"_31":121,"_108":109},"News API key for news aggregation","CACHE_ENABLED",{"_105":124,"_31":125,"_108":109},"true","Whether to enable caching","TUSHARE_TOKEN",{"_31":128,"_108":109},"A股数据访问token (required, get from https://tushare.pro/)","TAVILY_API_KEY",{"_31":131,"_108":109},"Tavily API key for AI search and research","FINNHUB_API_KEY",{"_31":134,"_108":109},"Finnhub API key for enhanced news data","required",[126],"object","githubProject",{"_35":36,"_140":141},"url","https://github.com/huweihua123/stock-mcp","githubRepository",{"_144":145,"_146":147,"_148":149,"_16":150,"_151":152,"_33":153,"_89":154,"_156":157,"_158":-5,"_159":160},"defaultBranch","main","fullName","huweihua123/stock-mcp","githubTreeId",1680889,29467,"language","Python","stock-mcp",{"_93":94,"_64":155},"rwmfm9nsrz","recentStargazers",7,"spdxLicense","stargazers",13,"glamaJson","inspectable",false,"npmPackage","supportedPlatforms","scores",{"_168":-5,"_169":-5,"_170":-5},"license","quality","security","simpleIcon","toolCount",0,"f1txcbq9n0","updatedAt","2025-10-08T07:04:06.800296Z","meta",[179,182,184,191,194,196,199,202,205,208,211,213,216,219,221,223,225,227,229],{"_180":181},"title","Stock MCP Server | Glama",{"_183":32,"_33":31},"content",{"_185":186,"_187":188,"_189":190},"href","https://glama.ai/mcp/servers/@huweihua123/stock-mcp","rel","canonical","tagName","link",{"_183":34,"_192":193},"property","og:title",{"_183":32,"_192":195},"og:description",{"_183":197,"_192":198},"https://glama.ai/logo.png","og:logo",{"_183":200,"_192":201},"https://glama.ai/mcp/servers/@huweihua123/stock-mcp/og-image","og:image",{"_183":203,"_192":204},"630","og:image:height",{"_183":206,"_192":207},"1200","og:image:width",{"_183":209,"_192":210},"website","og:type",{"_183":186,"_192":212},"og:url",{"_183":214,"_192":215},"Glama – MCP Hosting Platform","og:site_name",{"_183":217,"_33":218},"summary_large_image","twitter:card",{"_183":214,"_33":220},"twitter:title",{"_183":32,"_33":222},"twitter:description",{"_183":200,"_33":224},"twitter:image",{"_183":203,"_33":226},"twitter:image:height",{"_183":206,"_33":228},"twitter:image:width",{"_230":231},"script:ld+json",{"_232":233,"_234":235},"@context","http://schema.org","@graph",[236],{"_232":237,"_238":239,"_240":241},"https://schema.org","@type","BreadcrumbList","itemListElement",[242,249,253,257],{"_238":243,"_244":245,"_33":246,"_247":248},"ListItem","item","/","Glama","position",1,{"_238":243,"_244":250,"_33":251,"_247":252},"/mcp","MCP",2,{"_238":243,"_244":254,"_33":255,"_247":256},"/mcp/servers","Servers",3,{"_238":243,"_244":258,"_33":34,"_247":259},"/mcp/servers/@huweihua123/stock-mcp",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_263":264,"_29":270,"_301":302,"_177":316,"_313":340,"_341":342},"blob",{"_183":265,"_266":267,"_268":269},"# filepath: /Users/huweihua/java/stock-mcp/src/config/__init__.py\n\"\"\"\n配置模块\n\"\"\"\n","fileName","__init__.py","size",87,{"_41":42,"_13":271,"_50":32,"_51":32,"_16":52,"_53":272,"_33":34,"_87":281,"_95":-5,"_96":-5,"_97":284,"_166":300,"_171":-5,"_61":153,"_172":173,"_64":174,"_175":176},[44,45,46,47,48,49],[273,275,277,279],{"_56":274,"_31":63,"_64":65},{"_58":59,"_33":60,"_61":62},{"_56":276,"_31":71,"_64":72},{"_58":68,"_33":69,"_61":70},{"_56":278,"_31":78,"_64":79},{"_58":75,"_33":76,"_61":77},{"_56":280,"_31":85,"_64":86},{"_58":82,"_33":83,"_61":84},{"_89":282,"_61":94},{"_91":283},{"_93":94},{"_99":285,"_138":297,"_142":298,"_161":-5,"_162":163,"_164":-5,"_165":-5},{"_101":286,"_135":296,"_108":137},{"_103":287,"_110":288,"_113":289,"_116":290,"_119":291,"_122":292,"_126":293,"_129":294,"_132":295},{"_105":106,"_31":107,"_108":109},{"_31":112,"_108":109},{"_105":77,"_31":115,"_108":109},{"_31":118,"_108":109},{"_31":121,"_108":109},{"_105":124,"_31":125,"_108":109},{"_31":128,"_108":109},{"_31":131,"_108":109},{"_31":134,"_108":109},[126],{"_35":36,"_140":141},{"_144":145,"_146":147,"_148":149,"_16":150,"_151":152,"_33":153,"_89":299,"_156":157,"_158":-5,"_159":160},{"_93":94,"_64":155},{"_168":-5,"_169":-5,"_170":-5},"member",{"_303":304,"_307":308,"_309":310,"_148":311,"_312":163,"_313":267,"_314":315,"_268":269,"_108":263},"commit",{"_305":306},"sha","e461fdedc02e139a391c399108e475ed2515206c","contentStoredObjectPointerId",15203987,"fullPath","src/config/__init__.py",1680876,"indexable","path","safeToDisplayAsText",true,[317,319,321,323,325,326,327,329,330,331,332,333,334,335,336,337,338,339],{"_180":318},"__init__.py | Stock MCP Server | Glama",{"_183":320,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_185":322,"_187":188,"_189":190},"https://glama.ai/mcp/servers/@huweihua123/stock-mcp/blob/e461fdedc02e139a391c399108e475ed2515206c/src/config",{"_183":324,"_192":193},"__init__.py | Stock MCP Server",{"_183":320,"_192":195},{"_183":197,"_192":198},{"_183":328,"_192":201},"https://glama.ai/generated-images/og?title=__init__.py+%7C+Stock+MCP+Server",{"_183":203,"_192":204},{"_183":206,"_192":207},{"_183":209,"_192":210},{"_183":322,"_192":212},{"_183":214,"_192":215},{"_183":217,"_33":218},{"_183":214,"_33":220},{"_183":320,"_33":222},{"_183":328,"_33":224},{"_183":203,"_33":226},{"_183":206,"_33":228},"src/config","treeMembers",[343,345],{"_303":344,"_309":310,"_313":267,"_108":263},{"_305":306},{"_303":346,"_309":347,"_313":348,"_108":263},{"_305":306},"src/config/settings.py","settings.py","actionData","errors"]

MCP directory API