[{"_1":2,"_350":-5,"_351":-5},"loaderData",{"_3":4,"_22":23,"_262":263},"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",22064646,"membership","referenceId","019a38ab-d78c-7356-ab8d-f3fb85281c4a","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":41,"_178":179,"_261":164},"availableLocales",[],"githubUser","locale",{"_29":30,"_37":38,"_39":40},"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.","displayName","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","name","English","tag","en-US",{"_42":43,"_13":44,"_51":32,"_52":32,"_33":34,"_16":53,"_54":55,"_88":89,"_96":-5,"_97":-5,"_98":99,"_167":168,"_172":-5,"_62":154,"_173":174,"_65":175,"_176":177},"addedAt","2025-10-08T07:03:51.940700Z",[45,46,47,48,49,50],"category:finance","category:search","category:research-and-data","environment:network","hosting:remote-capable","language:python","descriptionMarkdown","descriptionPlainText",12358,"integrations",[56,67,74,81],{"_57":58,"_31":64,"_65":66},"brand",{"_59":60,"_37":61,"_62":63},"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",{"_57":68,"_31":72,"_65":73},{"_59":69,"_37":70,"_62":71},"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",{"_57":75,"_31":79,"_65":80},{"_59":76,"_37":77,"_62":78},"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",{"_57":82,"_31":86,"_65":87},{"_59":83,"_37":84,"_62":85},"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",{"_90":91,"_62":95},"owner",{"_92":93},"githubAccount",{"_94":95},"login","huweihua123","readmeMarkdown","redditPostExternalId","repository",{"_100":101,"_139":140,"_143":144,"_162":-5,"_163":164,"_165":-5,"_166":-5},"argumentsJsonSchema",{"_102":103,"_136":137,"_109":138},"properties",{"_104":105,"_111":112,"_114":115,"_117":118,"_120":121,"_123":124,"_127":128,"_130":131,"_133":134},"CACHE_TTL",{"_106":107,"_31":108,"_109":110},"default","3600","Cache expiration time in seconds","type","string","HTTP_PROXY",{"_31":113,"_109":110},"HTTP proxy configuration (recommended for US stock data access)","REDIS_HOST",{"_106":78,"_31":116,"_109":110},"Redis host (default: redis for Docker, localhost for local)","HTTPS_PROXY",{"_31":119,"_109":110},"HTTPS proxy configuration (recommended for US stock data access)","NEWS_API_KEY",{"_31":122,"_109":110},"News API key for news aggregation","CACHE_ENABLED",{"_106":125,"_31":126,"_109":110},"true","Whether to enable caching","TUSHARE_TOKEN",{"_31":129,"_109":110},"A股数据访问token (required, get from https://tushare.pro/)","TAVILY_API_KEY",{"_31":132,"_109":110},"Tavily API key for AI search and research","FINNHUB_API_KEY",{"_31":135,"_109":110},"Finnhub API key for enhanced news data","required",[127],"object","githubProject",{"_35":36,"_141":142},"url","https://github.com/huweihua123/stock-mcp","githubRepository",{"_145":146,"_147":148,"_149":150,"_16":151,"_152":153,"_37":154,"_90":155,"_157":158,"_159":-5,"_160":161},"defaultBranch","main","fullName","huweihua123/stock-mcp","githubTreeId",1680889,29467,"language","Python","stock-mcp",{"_94":95,"_65":156},"rwmfm9nsrz","recentStargazers",7,"spdxLicense","stargazers",13,"glamaJson","inspectable",false,"npmPackage","supportedPlatforms","scores",{"_169":-5,"_170":-5,"_171":-5},"license","quality","security","simpleIcon","toolCount",0,"f1txcbq9n0","updatedAt","2025-10-08T07:04:06.800296Z","meta",[180,183,185,192,195,197,200,203,206,209,212,214,217,220,222,224,226,228,230],{"_181":182},"title","Stock MCP Server | Glama",{"_184":32,"_37":31},"content",{"_186":187,"_188":189,"_190":191},"href","https://glama.ai/mcp/servers/@huweihua123/stock-mcp","rel","canonical","tagName","link",{"_184":34,"_193":194},"property","og:title",{"_184":32,"_193":196},"og:description",{"_184":198,"_193":199},"https://glama.ai/logo.png","og:logo",{"_184":201,"_193":202},"https://glama.ai/mcp/servers/@huweihua123/stock-mcp/og-image","og:image",{"_184":204,"_193":205},"630","og:image:height",{"_184":207,"_193":208},"1200","og:image:width",{"_184":210,"_193":211},"website","og:type",{"_184":187,"_193":213},"og:url",{"_184":215,"_193":216},"Glama – MCP Hosting Platform","og:site_name",{"_184":218,"_37":219},"summary_large_image","twitter:card",{"_184":215,"_37":221},"twitter:title",{"_184":32,"_37":223},"twitter:description",{"_184":201,"_37":225},"twitter:image",{"_184":204,"_37":227},"twitter:image:height",{"_184":207,"_37":229},"twitter:image:width",{"_231":232},"script:ld+json",{"_233":234,"_235":236},"@context","http://schema.org","@graph",[237],{"_233":238,"_239":240,"_241":242},"https://schema.org","@type","BreadcrumbList","itemListElement",[243,250,254,258],{"_239":244,"_245":246,"_37":247,"_248":249},"ListItem","item","/","Glama","position",1,{"_239":244,"_245":251,"_37":252,"_248":253},"/mcp","MCP",2,{"_239":244,"_245":255,"_37":256,"_248":257},"/mcp/servers","Servers",3,{"_239":244,"_245":259,"_37":34,"_248":260},"/mcp/servers/@huweihua123/stock-mcp",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_264":265,"_29":271,"_302":303,"_178":317,"_314":341,"_342":343},"blob",{"_184":266,"_267":268,"_269":270},"\"\"\"\n缓存模块初始化\n\"\"\"\n\nfrom .redis_cache import MacroDataCache\n\n__all__ = [\"MacroDataCache\"]\n","fileName","__init__.py","size",101,{"_42":43,"_13":272,"_51":32,"_52":32,"_33":34,"_16":53,"_54":273,"_88":282,"_96":-5,"_97":-5,"_98":285,"_167":301,"_172":-5,"_62":154,"_173":174,"_65":175,"_176":177},[45,46,47,48,49,50],[274,276,278,280],{"_57":275,"_31":64,"_65":66},{"_59":60,"_37":61,"_62":63},{"_57":277,"_31":72,"_65":73},{"_59":69,"_37":70,"_62":71},{"_57":279,"_31":79,"_65":80},{"_59":76,"_37":77,"_62":78},{"_57":281,"_31":86,"_65":87},{"_59":83,"_37":84,"_62":85},{"_90":283,"_62":95},{"_92":284},{"_94":95},{"_100":286,"_139":298,"_143":299,"_162":-5,"_163":164,"_165":-5,"_166":-5},{"_102":287,"_136":297,"_109":138},{"_104":288,"_111":289,"_114":290,"_117":291,"_120":292,"_123":293,"_127":294,"_130":295,"_133":296},{"_106":107,"_31":108,"_109":110},{"_31":113,"_109":110},{"_106":78,"_31":116,"_109":110},{"_31":119,"_109":110},{"_31":122,"_109":110},{"_106":125,"_31":126,"_109":110},{"_31":129,"_109":110},{"_31":132,"_109":110},{"_31":135,"_109":110},[127],{"_35":36,"_141":142},{"_145":146,"_147":148,"_149":150,"_16":151,"_152":153,"_37":154,"_90":300,"_157":158,"_159":-5,"_160":161},{"_94":95,"_65":156},{"_169":-5,"_170":-5,"_171":-5},"member",{"_304":305,"_308":309,"_310":311,"_149":312,"_313":164,"_314":268,"_315":316,"_269":270,"_109":264},"commit",{"_306":307},"sha","e461fdedc02e139a391c399108e475ed2515206c","contentStoredObjectPointerId",15795552,"fullPath","src/server/services/macro/cache/__init__.py",1680881,"indexable","path","safeToDisplayAsText",true,[318,320,322,324,326,327,328,330,331,332,333,334,335,336,337,338,339,340],{"_181":319},"__init__.py | Stock MCP Server | Glama",{"_184":321,"_37":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_186":323,"_188":189,"_190":191},"https://glama.ai/mcp/servers/@huweihua123/stock-mcp/blob/e461fdedc02e139a391c399108e475ed2515206c/src/server/services/macro/cache",{"_184":325,"_193":194},"__init__.py | Stock MCP Server",{"_184":321,"_193":196},{"_184":198,"_193":199},{"_184":329,"_193":202},"https://glama.ai/generated-images/og?title=__init__.py+%7C+Stock+MCP+Server",{"_184":204,"_193":205},{"_184":207,"_193":208},{"_184":210,"_193":211},{"_184":323,"_193":213},{"_184":215,"_193":216},{"_184":218,"_37":219},{"_184":215,"_37":221},{"_184":321,"_37":223},{"_184":329,"_37":225},{"_184":204,"_37":227},{"_184":207,"_37":229},"src/server/services/macro/cache","treeMembers",[344,346],{"_304":345,"_310":311,"_314":268,"_109":264},{"_306":307},{"_304":347,"_310":348,"_314":349,"_109":264},{"_306":307},"src/server/services/macro/cache/redis_cache.py","redis_cache.py","actionData","errors"]

MCP directory API