[{"_1":2,"_266":-5,"_267":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_210":211},"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",5890075,"membership","referenceId","01969a8b-0b87-7f62-abcc-0c4192fb8c4b","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_28":-5,"_29":30,"_31":42,"_127":128,"_209":89},"availableLocales",[],"githubUser","locale",{"_31":32,"_35":39,"_40":41},"mcpServer",{"_33":34,"_35":36,"_37":38},"description","A Model Context Protocol server focused on China's A-share stock market that provides data on stocks, financials, market indices, and macroeconomic indicators.","name","A-Share MCP Server","readme","

\n\n# 📊 a-share-mcp 📈\n\n

\n\n[![License](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square&logo=opensourceinitiative)](https://opensource.org/licenses/MIT)\n[![Python](https://img.shields.io/badge/Python-3.12+-blue.svg?style=flat-square&logo=python&logoColor=white)](https://www.python.org/downloads/)\n[![Package Manager](https://img.shields.io/badge/uv-package%20manager-5A45FF?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDEuNUwxIDEyLjVIMjNMMTIgMS41WiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTEyIDIyLjVMMSAxMS41SDIzTDEyIDIyLjVaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)](https://github.com/astral-sh/uv)\n[![MCP](https://img.shields.io/badge/MCP-Protocol-FF6B00?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48cGF0aCBkPSJNMTIgMkM2LjQ4NiAyIDIgNi40ODYgMiAxMnM0LjQ4NiAxMCAxMCAxMHMxMC00LjQ4NiAxMC0xMFMxNy41MTQgMiAxMiAyem0tMSAxNHY1LjI1QTguMDA4IDguMDA4IDAgMCAxIDQuNzUgMTZ6bTIgMGg2LjI1QTguMDA4IDguMDA4IDAgMCAxIDEzIDE2em0xLTJWOWg1LjI1QTguMDIgOC4wMiAwIDAAxIDE0IDE0em0tMiAwSDYuNzVBOC4wMiA4LjAyIDAgMDEgMTEgMTR6bTAtNlY0Ljc1QTguMDA4IDguMDA4IDAgMCAxIDE5LjI1IDh6TTEwIDh2NUg0Ljc1QTguMDA3IDguMDA3IDAgMCAxIDEwIDh6IiBmaWxsPSJ3aGl0ZSIvPjwvc3ZnPg==)](https://github.com/model-context-protocol/mcp-spec)\n\n

\n\n

\n\n本项目是一个基于专注于 A 股市场的 MCP 服务器，它提供股票基本信息、历史 K 线数据、财务指标、宏观经济数据等多种查询功能，理论上来说，可以回答有关 A 股市场的任何问题，无论是针对大盘还是特定股票。\n\n

\n\n## 项目结构\n\n```\na_share_mcp/\n│\n├── mcp_server.py # 主服务器入口文件\n├── pyproject.toml # 项目依赖配置\n├── README.md # 项目说明文档\n│\n├── docs/ # 项目文档\n│ ├── baostock_com.md # Baostock API文档\n│ ├── mcp_server_docs.md # 服务器文档\n│ └── dev_docs/ # 开发文档\n│ ├── AppFlow.md\n│ ├── ImplementationPlan.md\n│ └── PRD.md\n│\n├── src/ # 源代码目录\n│ ├── __init__.py\n│ ├── baostock_data_source.py # Baostock数据源实现\n│ ├── data_source_interface.py # 数据源接口定义\n│ ├── utils.py # 通用工具函数\n│ │\n│ ├── formatting/ # 数据格式化模块\n│ │ ├── __init__.py\n│ │ └── markdown_formatter.py # Markdown格式化工具\n│ │\n│ └── tools/ # MCP工具模块\n│ ├── __init__.py\n│ ├── base.py # 基础工具函数\n│ ├── stock_market.py # 股票市场数据工具\n│ ├── financial_reports.py # 财务报表工具\n│ ├── indices.py # 指数相关工具\n│ ├── market_overview.py # 市场概览工具\n│ ├── macroeconomic.py # 宏观经济数据工具\n│ ├── date_utils.py # 日期工具\n│ └── analysis.py # 分析工具\n│\n└── resource/ # 资源文件\n └── img/ # 图片资源\n ├── img_1.png # CherryStudio配置示例\n └── img_2.png # CherryStudio配置示例\n```\n\n

\n\n## 功能特点\n\n

\n\n \n \n \n \n \n \n \n \n \n \n

股票基础数据	历史行情数据	财务报表数据
宏观经济数据	指数成分股	数据分析报告

\n\n## 先决条件\n\n1. **Python 环境**: Python 3.10+\n2. **依赖管理**: 使用 `uv` 包管理器安装依赖\n3. **数据来源**: 基于 Baostock 数据源，无需付费账号。在此感谢 Baostock。\n4. 提醒：本项目于 Windows 环境下开发。\n\n## 数据更新时间\n\n> 以下是 Baostock 官方数据更新时间，请注意查询最新数据时的时间点 [Baostock 官网](http://baostock.com/baostock/index.php/%E9%A6%96%E9%A1%B5)\n\n**每日数据更新时间：**\n\n- 当前交易日 17:30，完成日 K 线数据入库\n- 当前交易日 18:00，完成复权因子数据入库\n- 第二自然日 11:00，完成分钟 K 线数据入库\n- 第二自然日 1:30，完成前交易日\"其它财务报告数据\"入库\n- 周六 17:30，完成周线数据入库\n\n**每周数据更新时间：**\n\n- 每周一下午，完成上证 50 成份股、沪深 300 成份股、中证 500 成份股信息数据入库\n\n> 所以说，在交易日的当天，如果是在 17:30 之前询问当天的数据，是无法获取到的。\n\n## 安装环境\n\n在项目根目录下执行：\n\n要启动 A 股 MCP 服务器，请按照以下步骤操作：\n\n```bash\n# 1. 创建虚拟环境（仅创建，不会安装任何包）\nuv venv\n\n# 2. 激活虚拟环境\n# Windows\n.venv\\Scripts\\activate\n# macOS/Linux\n# source .venv/bin/activate\n\n# 3. 安装所有依赖（必须在激活的虚拟环境中执行）\nuv sync\n```\n\n## 使用：在 MCP 客户端中配置服务器\n\n在支持 MCP 的客户端（如 VS Code 插件、CherryStudio 等）中，你需要配置如何启动此服务器。 **推荐使用 `uv`**。\n\n### 方法一：使用 JSON 配置的 IDE (例如 Cursor、VSCode、Trae 等)\n\n对于需要编辑 JSON 文件来配置 MCP 服务器的客户端，你需要找到对应的能配置 MCP 的地方（各个 IDE 和桌面 MCP Client 可能都不一样），并在 `mcpServers` 对象中添加一个新的条目。\n\n**JSON 配置示例 (请将路径替换为你的实际绝对路径):**\n\n```json\n{\n \"mcpServers\": {\n \"a-share-mcp\": {\n \"command\": \"uv\", // 或者 uv.exe 的绝对路径, 例如: \"C:\\\\path\\\\to\\\\uv.exe\"\n \"args\": [\n \"--directory\",\n \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", // 替换为你的项目根目录绝对路径，不一定是C盘，按实际的填写\n \"run\",\n \"python\",\n \"mcp_server.py\"\n ],\n \"transport\": \"stdio\"\n // \"workingDirectory\": \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", // 使用 uv --directory 后，此项可能不再必需，但建议保留作为备用\n }\n // ... other servers ...\n }\n}\n```\n\n**注意事项:**\n\n- **`command`**: 确保填写的 `uv` 命令或 `uv.exe` 的绝对路径是客户端可以访问和执行的。\n- **`args`**: 确保参数列表完整且顺序正确。\n- **路径转义**: 路径需要写成双反斜杠 `\\\\`。\n > 这是 Windows 系统特有的情况。如果是在 macOS 或 Linux 系统中，路径使用正斜杠/作为目录分隔符，就不需要这种转义处理。\n- **`workingDirectory`**: 虽然 `uv --directory` 应该能解决工作目录问题，但如果客户端仍然报错 `ModuleNotFoundError`，可以尝试在客户端配置中明确设置此项为项目根目录的绝对路径。\n\n### 方法二：使用 CherryStudio\n\n在 CherryStudio 的 MCP 服务器配置界面中，按如下方式填写：\n\n- **名称**: `a-share-mcp` (或自定义)\n- **描述**: `本地 A 股 MCP 服务器` (或自定义)\n- **类型**: 选择 **标准输入/输出 (stdio)**\n- **命令**: `uv` (或者填系统中绝对路径下 uv.exe)\n- **包管理源**: 默认\n- **参数**:\n\n 1. 第一个参数填: `--directory`\n 2. 第二个参数填: `C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp`\n 3. 第三个参数填: `run`\n 4. 第四个参数填: `python`\n 5. 第五个参数填: `mcp_server.py`\n\n - _确保所有参数按下回车转行隔开的，否则报错（是不是手把手教学了？）_\n\n- **环境变量**: (通常留空)\n\n> Tricks（必看）:\n> 有时候在 Cherrystudio 填写好参数后，点击右上方的开关按钮，会发现没任何反应，此时只要随便点击左侧目录任一按钮，跳出 mcp 设置界面，然后再回到 mcp 设置界面，就会发现 mcp 已经闪绿灯配置成功了。\n\n**CherryStudio 使用示例:**\n理论上来说，你可以问有关 A 股的任何问题 :)\n\n![CherryStudio配置示例1](resource/img/img_1.png)\n\n![CherryStudio配置示例2](resource/img/img_2.png)\n\n**重要提示:**\n\n- 确保**命令**字段中的 `uv` 或其绝对路径有效且可执行。\n- 确保**参数**字段按顺序正确填写了五个参数。\n\n## 工具列表\n\n该 MCP 服务器提供以下工具：\n\n

🔍 展开查看全部工具

\n
\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

🏛️ 股票市场数据	📊 财务报表数据	🔎 市场概览数据
\n \n `get_historical_k_data` \n `get_stock_basic_info` \n `get_dividend_data` \n `get_adjust_factor_data` \n \n	\n \n `get_profit_data` \n `get_operation_data` \n `get_growth_data` \n `get_balance_data` \n `get_cash_flow_data` \n `get_dupont_data` \n \n	\n \n `get_trade_dates` \n `get_all_stock` \n \n
📈 指数相关数据	🌐 宏观经济数据	⏰ 日期工具 & 分析
\n \n `get_stock_industry` \n `get_sz50_stocks` \n `get_hs300_stocks` \n `get_zz500_stocks` \n \n	\n \n `get_deposit_rate_data` \n `get_loan_rate_data` \n `get_required_reserve_ratio_data` \n `get_money_supply_data_month` \n `get_money_supply_data_year` \n `get_shibor_data` \n \n	\n \n \n `get_latest_trading_date` \n `get_stock_analysis` \n \n

\n\n## 贡献指南\n\n欢迎提交 Issue 或 Pull Request 来帮助改进项目。贡献前请先查看现有 Issue 和文档。\n\n## ☕️ 请作者喝杯咖啡\n\n如果这个项目对你有帮助，欢迎请我喝杯咖啡 ❤️\n\n $\"支付宝收款码\"$ \n\n### 🌟 加入我们的社区\n\n=======\n\n同时也欢迎关注我们的公众号【空指针指向量化 Agent】，获取更多量化投资和 AI 智能交易相关的干货内容！ 🚀\n\n

关注公众号【空指针指向了量化 Agent】，获取更多量化投资和 AI 智能交易相关的干货内容！\n $\"公众号二维码\"$ \n

\n\n> 另外，诚挚邀请各位加入我的知识星球（一顿饭钱：99¥）\n\n> （微信号: PareidoliaX，加微信后，我拉你进星球。该微信只做邀请用途，不做任何私人回复。非加星球请勿扰哈。），\n\n> 星球中还有更多我个人分享的资料和对该项目的解析。\n> 另外，星球会提前更新代码，抢先体验不容错过。\n\n## 许可证\n\n本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件\n\n

\n","English","tag","en-US",{"_43":44,"_45":46,"_13":53,"_57":34,"_58":34,"_59":60,"_63":64,"_86":-5,"_16":87,"_88":89,"_90":91,"_35":36,"_108":77,"_109":-5,"_110":-5,"_111":-5,"_112":-5,"_113":114,"_119":-5,"_98":73,"_120":121,"_123":-5,"_78":124,"_125":126},"addedAt",["D",1746169247168],"argumentsJsonSchema",{"_47":48,"_49":50,"_51":52},"properties",{},"required",[],"type","object",[54,55,56],"language:python","license_grade:a","author:claimed","descriptionMarkdown","descriptionPlainText","githubProject",{"_37":38,"_61":62},"url","https://github.com/24mlight/a-share-mcp-is-just-i-need","githubRepository",{"_65":66,"_67":68,"_69":70,"_71":72,"_35":73,"_74":75,"_80":81,"_82":83,"_85":81},"defaultBranch","main","fullName","24mlight/a-share-mcp-is-just-i-need","githubTreeId",113470,"language","Python","a-share-mcp-is-just-i-need","owner",{"_76":77,"_78":79},"login","24mlight","uid","iyvyYM7eUI","recentStargazers",83,"spdxLicense",{"_35":84},"MIT License","stargazers","glamaJson",6211,"inspectable",false,"integrations",[92,102],{"_93":94,"_33":100,"_78":101},"brand",{"_95":96,"_35":97,"_98":99},"logoSvgPath","M22.27 19.385H1.73A1.73 1.73 0 010 17.655V6.345a1.73 1.73 0 011.73-1.73h20.54A1.73 1.73 0 0124 6.345v11.308a1.73 1.73 0 01-1.73 1.731zM5.769 15.923v-4.5l2.308 2.885 2.307-2.885v4.5h2.308V8.078h-2.308l-2.307 2.885-2.308-2.885H3.46v7.847zM21.232 12h-2.309V8.077h-2.307V12h-2.308l3.461 4.039z","Markdown","slug","markdown","Handles data formatting and presentation using Markdown, allowing for structured output of financial data, stock analysis, and market reports.","xmhutems0j",{"_93":103,"_33":106,"_78":107},{"_95":104,"_35":72,"_98":105},"M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z","python","Provides a Python-based MCP server implementation for accessing A-share market data, offering historical stock data, financial reports, market overview, and economic indicators for Chinese stock markets.","ihz6gjlkng","namespace","npmPackage","prompts","redditPostForeignId","resources","scores",{"_115":116,"_117":-5,"_118":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[122],"WINDOWS","tools","1texju8e14","updatedAt",["D",1746169288097],"meta",[129,132,134,141,144,146,149,152,155,158,161,163,166,169,171,173,175,177,179],{"_130":131},"title","A-Share MCP Server | Glama",{"_133":34,"_35":33},"content",{"_135":136,"_137":138,"_139":140},"href","https://glama.ai/mcp/servers/@24mlight/a-share-mcp-is-just-i-need","rel","canonical","tagName","link",{"_133":36,"_142":143},"property","og:title",{"_133":34,"_142":145},"og:description",{"_133":147,"_142":148},"https://glama.ai/logo.png","og:logo",{"_133":150,"_142":151},"https://glama.ai/mcp/servers/@24mlight/a-share-mcp-is-just-i-need/og-image","og:image",{"_133":153,"_142":154},"630","og:image:height",{"_133":156,"_142":157},"1200","og:image:width",{"_133":159,"_142":160},"website","og:type",{"_133":136,"_142":162},"og:url",{"_133":164,"_142":165},"Glama – MCP Hosting Platform","og:site_name",{"_133":167,"_35":168},"summary_large_image","twitter:card",{"_133":164,"_35":170},"twitter:title",{"_133":34,"_35":172},"twitter:description",{"_133":150,"_35":174},"twitter:image",{"_133":153,"_35":176},"twitter:image:height",{"_133":156,"_35":178},"twitter:image:width",{"_180":181},"script:ld+json",{"_182":183,"_184":185},"@context","http://schema.org","@graph",[186],{"_182":187,"_188":189,"_190":191},"https://schema.org","@type","BreadcrumbList","itemListElement",[192,199,203,207],{"_188":193,"_194":195,"_35":196,"_197":198},"ListItem","item","https://glama.ai/","Glama","position",1,{"_188":193,"_194":200,"_35":201,"_197":202},"https://glama.ai/mcp","MCP",2,{"_188":193,"_194":204,"_35":205,"_197":206},"https://glama.ai/mcp/servers","Servers",3,{"_188":193,"_194":136,"_35":36,"_197":208},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_28":-5,"_31":212,"_127":230,"_265":-5},{"_43":213,"_45":214,"_13":217,"_57":34,"_58":34,"_59":218,"_63":219,"_86":-5,"_16":87,"_88":89,"_90":222,"_35":36,"_108":77,"_109":-5,"_110":-5,"_111":-5,"_112":-5,"_113":227,"_119":-5,"_98":73,"_120":228,"_123":-5,"_78":124,"_125":229},["D",1746169247168],{"_47":215,"_49":216,"_51":52},{},[],[54,55,56],{"_37":38,"_61":62},{"_65":66,"_67":68,"_69":70,"_71":72,"_35":73,"_74":220,"_80":81,"_82":221,"_85":81},{"_76":77,"_78":79},{"_35":84},[223,225],{"_93":224,"_33":100,"_78":101},{"_95":96,"_35":97,"_98":99},{"_93":226,"_33":106,"_78":107},{"_95":104,"_35":72,"_98":105},{"_115":116,"_117":-5,"_118":-5},[122],["D",1746169288097],[231,233,235,237,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253],{"_130":232},"Reviews | A-Share MCP Server | Glama",{"_133":234,"_35":33},"Read community reviews and feedback for A-Share MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_135":236,"_137":138,"_139":140},"https://glama.ai/mcp/servers/@24mlight/a-share-mcp-is-just-i-need/reviews",{"_133":238,"_142":143},"Reviews | A-Share MCP Server",{"_133":234,"_142":145},{"_133":147,"_142":148},{"_133":150,"_142":151},{"_133":153,"_142":154},{"_133":156,"_142":157},{"_133":159,"_142":160},{"_133":236,"_142":162},{"_133":164,"_142":165},{"_133":167,"_35":168},{"_133":164,"_35":170},{"_133":234,"_35":172},{"_133":150,"_35":174},{"_133":153,"_35":176},{"_133":156,"_35":178},{"_180":254},{"_182":183,"_184":255},[256],{"_182":187,"_188":189,"_190":257},[258,259,260,261,262],{"_188":193,"_194":195,"_35":196,"_197":198},{"_188":193,"_194":200,"_35":201,"_197":202},{"_188":193,"_194":204,"_35":205,"_197":206},{"_188":193,"_194":136,"_35":36,"_197":208},{"_188":193,"_194":236,"_35":263,"_197":264},"Reviews",5,"review","actionData","errors"]

Rate & Review