[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-24mlight--a-share-mcp-is-just-i-need":3,"tool-24mlight--a-share-mcp-is-just-i-need":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",158594,2,"2026-04-16T23:34:05",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":66,"owner_location":66,"owner_email":66,"owner_twitter":66,"owner_website":66,"owner_url":77,"languages":78,"stars":83,"forks":84,"last_commit_at":85,"license":86,"difficulty_score":32,"env_os":87,"env_gpu":88,"env_ram":88,"env_deps":89,"category_tags":95,"github_topics":66,"view_count":32,"oss_zip_url":66,"oss_zip_packed_at":66,"status":17,"created_at":96,"updated_at":97,"faqs":98,"releases":125},8309,"24mlight\u002Fa-share-mcp-is-just-i-need","a-share-mcp-is-just-i-need",null,"a-share-mcp-is-just-i-need 是一款专为 A 股市场打造的 Model Context Protocol (MCP) 服务器工具。它旨在解决大语言模型在回答股市相关问题时缺乏实时、准确数据支持的问题，让 AI 助手能够直接查询并分析真实的 A 股行情。\n\n通过集成该工具，用户可以轻松获取股票基本信息、历史 K 线走势、详细财务指标、大盘指数以及宏观经济数据。无论是询问特定个股的表现，还是分析整体市场趋势，它都能提供详实的数据支撑，理论上可回应关于 A 股的各类疑问。\n\n这款工具特别适合开发者、量化研究人员以及希望将本地金融数据接入 AI 工作流的技术爱好者。其核心亮点在于基于标准的 MCP 协议构建，能够无缝对接支持该协议的各类 AI 客户端（如 CherryStudio），实现了数据源与模型上下文的解耦。项目采用 Python 编写，结构清晰，内置了 Baostock 数据源及多种格式化模块，方便用户进行二次开发或直接部署使用，是构建智能金融助手的理想基础设施。","\u003Cdiv align=\"center\">\n\n# 📊 a-share-mcp 📈\n\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FA股数据-MCP%20工具-E6162D?style=for-the-badge&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiB2aWV3Qm94PSIwIDAgMjQgMjQiPg0KPHBhdGggZmlsbD0iI2ZmZiIgZD0iTTggMTAuOGMwIDAgMC44LTEuNSAyLjQtMS41IDEuNyAwIDIuOCAxLjUgNC44IDEuNSAxLjcgMCAyLjgtMC42IDIuOC0wLjZ2LTIuMmMwIDAtMS4xIDEuMS0yLjggMS4xLTIgMC0zLjEtMS41LTQuOC0xLjUtMS42IDAtMi40IDAuOS0yLjQgMC45djIuM3pNOCAxNC44YzAgMCAwLjgtMS41IDIuNC0xLjUgMS43IDAgMi44IDEuNSA0LjggMS41IDEuNyAwIDIuOC0wLjYgMi44LTAuNnYtMi4yYzAgMC0xLjEgMS4xLTIuOCAxLjEtMiAwLTMuMS0xLjUtNC44LTEuNS0xLjYgMC0yLjQgMC45LTIuNCAwLjl2Mi4zeiI+PC9wYXRoPg0KPC9zdmc+\">\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg?style=flat-square&logo=opensourceinitiative)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.12+-blue.svg?style=flat-square&logo=python&logoColor=white)](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n[![Package Manager](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fuv-package%20manager-5A45FF?style=flat-square&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDEuNUwxIDEyLjVIMjNMMTIgMS41WiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTEyIDIyLjVMMSAxMS41SDIzTDEyIDIyLjVaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv)\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Protocol-FF6B00?style=flat-square&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48cGF0aCBkPSJNMTIgMkM2LjQ4NiAyIDIgNi40ODYgMiAxMnM0LjQ4NiAxMCAxMCAxMHMxMC00LjQ4NiAxMC0xMFMxNy41MTQgMiAxMiAyem0tMSAxNHY1LjI1QTguMDA4IDguMDA4IDAgMCAxIDQuNzUgMTZ6bTIgMGg2LjI1QTguMDA4IDguMDA4IDAgMCAxIDEzIDE2em0xLTJWOWg1LjI1QTguMDIgOC4wMiAwIDAAxIDE0IDE0em0tMiAwSDYuNzVBOC4wMiA4LjAyIDAgMDEgMTEgMTR6bTAtNlY0Ljc1QTguMDA4IDguMDA4IDAgMCAxIDE5LjI1IDh6TTEwIDh2NUg0Ljc1QTguMDA3IDguMDA3IDAgMCAxIDEwIDh6IiBmaWxsPSJ3aGl0ZSIvPjwvc3ZnPg==)](https:\u002F\u002Fgithub.com\u002Fmodel-context-protocol\u002Fmcp-spec)\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_122e13262062.png\" \u002F>\n\n\u003C\u002Fdiv>\nA股mcp。\n\n本项目是一个基于专注于 A 股市场的 MCP 服务器，它提供股票基本信息、历史 K 线数据、财务指标、宏观经济数据等多种查询功能，理论上来说，可以回答有关 A 股市场的任何问题，无论是针对大盘还是特定股票。\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_9de491912502.png\" width=\"100%\">\n\u003C\u002Fdiv>\n\n## 项目结构\n\n```\na_share_mcp\u002F\n│\n├── mcp_server.py           # 主服务器入口文件\n├── pyproject.toml          # 项目依赖配置\n├── README.md               # 项目说明文档\n│\n├── src\u002F                    # 源代码目录\n│   ├── __init__.py\n│   ├── baostock_data_source.py   # Baostock数据源实现\n│   ├── data_source_interface.py  # 数据源接口定义\n│   ├── utils.py                  # 通用工具函数\n│   │\n│   ├── formatting\u002F         # 数据格式化模块\n│   │   ├── __init__.py\n│   │   └── markdown_formatter.py  # Markdown格式化工具\n│   │\n│   └── tools\u002F              # 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\u002F               # 资源文件\n    └── img\u002F                # 图片资源\n        ├── img_1.png       # CherryStudio配置示例\n        └── img_2.png       # CherryStudio配置示例\n```\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_9de491912502.png\" width=\"100%\">\n\u003C\u002Fdiv>\n\n## 功能特点\n\n\u003Cdiv align=\"center\">\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_4fe9852925df.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>股票基础数据\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_d8209e7c6d96.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>历史行情数据\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_3447d18ca129.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>财务报表数据\u003C\u002Fb>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_e3c2dcf8c876.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>宏观经济数据\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_11109b0fa355.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>指数成分股\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_863fafbfa771.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>数据分析报告\u003C\u002Fb>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n## 先决条件\n\n1. **Python 环境**: Python 3.10+\n2. **依赖管理**: 使用 `uv` 包管理器安装依赖\n3. **数据来源**: 基于 Baostock 数据源，无需付费账号。在此感谢 Baostock。\n4. 提醒：本项目于 Windows 环境下开发。\n\n## 数据更新时间\n\n> 以下是 Baostock 官方数据更新时间，请注意查询最新数据时的时间点 [Baostock 官网](http:\u002F\u002Fbaostock.com\u002Fbaostock\u002Findex.php\u002F%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\u002FLinux\n# source .venv\u002Fbin\u002Factivate\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\", \u002F\u002F 或者 uv.exe 的绝对路径, 例如: \"C:\\\\path\\\\to\\\\uv.exe\"\n      \"args\": [\n        \"--directory\",\n        \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", \u002F\u002F 替换为你的项目根目录绝对路径，不一定是C盘，按实际的填写\n        \"run\",\n        \"python\",\n        \"mcp_server.py\"\n      ],\n      \"transport\": \"stdio\"\n      \u002F\u002F \"workingDirectory\": \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", \u002F\u002F 使用 uv --directory 后，此项可能不再必需，但建议保留作为备用\n    }\n    \u002F\u002F ... other servers ...\n  }\n}\n```\n\n**注意事项:**\n\n- **`command`**: 确保填写的 `uv` 命令或 `uv.exe` 的绝对路径是客户端可以访问和执行的。\n- **`args`**: 确保参数列表完整且顺序正确。\n- **路径转义**: 路径需要写成双反斜杠 `\\\\`。\n  > 这是 Windows 系统特有的情况。如果是在 macOS 或 Linux 系统中，路径使用正斜杠\u002F作为目录分隔符，就不需要这种转义处理。\n- **`workingDirectory`**: 虽然 `uv --directory` 应该能解决工作目录问题，但如果客户端仍然报错 `ModuleNotFoundError`，可以尝试在客户端配置中明确设置此项为项目根目录的绝对路径。\n\n### 方法二：使用 CherryStudio\n\n在 CherryStudio 的 MCP 服务器配置界面中，按如下方式填写：\n\n- **名称**: `a-share-mcp` (或自定义)\n- **描述**: `本地 A 股 MCP 服务器` (或自定义)\n- **类型**: 选择 **标准输入\u002F输出 (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](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_ee1510e7c7c1.png)\n\n![CherryStudio配置示例2](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_97440bc45a97.png)\n\n**重要提示:**\n\n- 确保**命令**字段中的 `uv` 或其绝对路径有效且可执行。\n- 确保**参数**字段按顺序正确填写了五个参数。\n\n## 工具列表\n\n该 MCP 服务器目前提供 **41** 个工具，覆盖股票、财报、宏观、日期分析等全方位数据。以下是完整列表：\n\n\u003Cdiv align=\"center\">\n  \u003Cdetails>\n    \u003Csummary>\u003Cb>🔍 展开查看全部工具\u003C\u002Fb>\u003C\u002Fsummary>\n    \u003Cbr>\n    \u003Ctable>\n      \u003Ctr>\n        \u003Cth>🏛️ 股票市场数据 (Stock)\u003C\u002Fth>\n        \u003Cth>📊 财务报表数据 (Finance)\u003C\u002Fth>\n      \u003C\u002Ftr>\n      \u003Ctr valign=\"top\">\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_historical_k_data\u003C\u002Fcode> (历史K线)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_stock_basic_info\u003C\u002Fcode> (基础信息)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_dividend_data\u003C\u002Fcode> (分红配送)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_adjust_factor_data\u003C\u002Fcode> (复权因子)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_profit_data\u003C\u002Fcode> (盈利能力)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_operation_data\u003C\u002Fcode> (营运能力)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_growth_data\u003C\u002Fcode> (成长能力)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_balance_data\u003C\u002Fcode> (资产负债)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_cash_flow_data\u003C\u002Fcode> (现金流量)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_dupont_data\u003C\u002Fcode> (杜邦分析)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_performance_express_report\u003C\u002Fcode> (业绩快报)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_forecast_report\u003C\u002Fcode> (业绩预告)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_fina_indicator\u003C\u002Fcode> (财务指标汇总)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n      \u003C\u002Ftr>\n      \u003Ctr>\n        \u003Cth>🔎 市场 & 指数 (Market & Index)\u003C\u002Fth>\n        \u003Cth>🌐 宏观 & 其它 (Macro & Utils)\u003C\u002Fth>\n      \u003C\u002Ftr>\n      \u003Ctr valign=\"top\">\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_trade_dates\u003C\u002Fcode> (交易日历)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_all_stock\u003C\u002Fcode> (全市场证券)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>search_stocks\u003C\u002Fcode> (股票搜索)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_suspensions\u003C\u002Fcode> (停牌信息)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_stock_industry\u003C\u002Fcode> (行业分类)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_index_constituents\u003C\u002Fcode> (指数成分)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_sz50_stocks\u003C\u002Fcode> (上证50)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_hs300_stocks\u003C\u002Fcode> (沪深300)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_zz500_stocks\u003C\u002Fcode> (中证500)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>list_industries\u003C\u002Fcode> (行业列表)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_industry_members\u003C\u002Fcode> (行业个股)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_deposit_rate_data\u003C\u002Fcode> (存款利率)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_loan_rate_data\u003C\u002Fcode> (贷款利率)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_required_reserve_ratio_data\u003C\u002Fcode> (存款准备金)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_money_supply_data_month\u003C\u002Fcode> (货币供应月)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_money_supply_data_year\u003C\u002Fcode> (货币供应年)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_latest_trading_date\u003C\u002Fcode> (最新交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_market_analysis_timeframe\u003C\u002Fcode> (智能分析周期)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>is_trading_day\u003C\u002Fcode> (判断交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>previous_trading_day\u003C\u002Fcode> (上一交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>next_trading_day\u003C\u002Fcode> (下一交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_last_n_trading_days\u003C\u002Fcode> (最近N日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_recent_trading_range\u003C\u002Fcode> (近期范围)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_month_end_trading_dates\u003C\u002Fcode> (月末交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_stock_analysis\u003C\u002Fcode> (生成分析报告)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>normalize_stock_code\u003C\u002Fcode> (代码标准化)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>normalize_index_code\u003C\u002Fcode> (指数代码标准化)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>list_tool_constants\u003C\u002Fcode> (常量查询)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n      \u003C\u002Ftr>\n    \u003C\u002Ftable>\n  \u003C\u002Fdetails>\n\u003C\u002Fdiv>\n\n## 贡献指南\n\n欢迎提交 Issue 或 Pull Request 来帮助改进项目。贡献前请先查看现有 Issue 和文档。\n\n## ☕️ 请作者喝杯咖啡\n\n如果这个项目对你有帮助，欢迎请我喝杯咖啡 ❤️\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_4b130a28c11e.png\" alt=\"支付宝收款码\" width=\"300\"\u002F>\n\n## 许可证\n\n本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_24ddebb9ab59.png\" \u002F>\n\u003C\u002Fdiv>\n\n## 本次更新概览（2025-12-25）\n\n本次更新新增 **财务指标汇总工具**，将 6 大类财务数据聚合为一个便捷查询接口。\n\n### 🆕 新增工具\n\n- **财务指标汇总**: `get_fina_indicator` 一键获取 6 大类财务指标（盈利能力、营运能力、成长能力、偿债能力、现金流量、杜邦分析），按季度返回合并数据。\n","\u003Cdiv align=\"center\">\n\n# 📊 a-share-mcp 📈\n\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FA股数据-MCP%20工具-E6162D?style=for-the-badge&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiB2aWV3Qm94PSIwIDAgMjQgMjQiPg0KPHBhdGggZmlsbD0iI2ZmZiIgZD0iTTggMTAuOGMwIDAgMC44LTEuNSAyLjQtMS41IDEuNyAwIDIuOCAxLjUgNC44IDEuNSAxLjcgMCAyLjgtMC42IDIuOC0wLjZ2LTIuMmMwIDAtMS4xIDEuMS0yLjggMS4xLTIgMC0zLjEtMS41LTQuOC0xLjUtMS42IDAtMi40IDAuOS0yLjQgMC45djIuM3pNOCAxNC44YzAgMCAwLjgtMS41IDIuNC0xLjUgMS43IDAgMi44IDEuNSA0LjggMS41IDEuNyAwIDIuOC0wLjYgMi44LTAuNnYtMi4yYzAgMC0xLjEgMS4xLTIuOCAxLjEtMiAwLTMuMS0xLjUtNC44LTEuNS0xLjYgMC0yLjQgMC45LTIuNCAwLjl2Mi4zeiI+PC9wYXRoPg0KPC9zdmc+\">\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg?style=flat-square&logo=opensourceinitiative)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.12+-blue.svg?style=flat-square&logo=python&logoColor=white)](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n[![Package Manager](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fuv-package%20manager-5A45FF?style=flat-square&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDEuNUwxIDEyLjVIMjNMMTIgMS41WiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTEyIDIyLjVMMSAxMS41SDIzTDEyIDIyLjVaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv)\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Protocol-FF6B00?style=flat-square&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48cGF0aCBkPSJNMTIgMkM2LjQ4NiAyIDIgNi40ODYgMiAxMnM0LjQ4NiAxMCAxMCAxMHMxMC00LjQ4NiAxMC0xMFMxNy41MTQgMiAxMiAyem0tMSAxNHY1LjI1QTguMDA4IDguMDA4IDAgMCAxIDQuNzUgMTZ6bTIgMGg2LjI1QTguMDA4IDguMDA4IDAgMCAxIDEzIDE2em0xLTJWOWh5LjI1QTguMDIgOC4wMiAwIDAAxIDE0IDE0em0tMiAwSDYuNzVBOC4wMiA4LjAyIDAgMDEgMTEgMTR6bTAtNlY0Ljc1QTguMDA4IDguMDA4IDAgMCAxIDE5LjI1IDh6TTEwIDh2NUH4Ljc1QTguMDA3IDguMDA3IDAgMCAxIDEwIDh6IiBmaWxsPSJ3aGl0ZSIvPjwvc3ZnPg==)](https:\u002F\u002Fgithub.com\u002Fmodel-context-protocol\u002Fmcp-spec)\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_122e13262062.png\" \u002F>\n\n\u003C\u002Fdiv>\nA股mcp。\n\n本项目是一个基于专注于 A 股市场的 MCP 服务器，它提供股票基本信息、历史 K 线数据、财务指标、宏观经济数据等多种查询功能，理论上来说，可以回答有关 A 股市场的任何问题，无论是针对大盘还是特定股票。\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_9de491912502.png\" width=\"100%\">\n\u003C\u002Fdiv>\n\n## 项目结构\n\n```\na_share_mcp\u002F\n│\n├── mcp_server.py           # 主服务器入口文件\n├── pyproject.toml          # 项目依赖配置\n├── README.md               # 项目说明文档\n│\n├── src\u002F                    # 源代码目录\n│   ├── __init__.py\n│   ├── baostock_data_source.py   # Baostock数据源实现\n│   ├── data_source_interface.py  # 数据源接口定义\n│   ├── utils.py                  # 通用工具函数\n│   │\n│   ├── formatting\u002F         # 数据格式化模块\n│   │   ├── __init__.py\n│   │   └── markdown_formatter.py  # Markdown格式化工具\n│   │\n│   └── tools\u002F              # 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\u002F               # 资源文件\n    └── img\u002F                # 图片资源\n        ├── img_1.png       # CherryStudio配置示例\n        └── img_2.png       # CherryStudio配置示例\n```\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_9de491912502.png\" width=\"100%\">\n\u003C\u002Fdiv>\n\n## 功能特点\n\n\u003Cdiv align=\"center\">\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_4fe9852925df.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>股票基础数据\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_d8209e7c6d96.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>历史行情数据\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_3447d18ca129.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>财务报表数据\u003C\u002Fb>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_e3c2dcf8c876.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>宏观经济数据\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_11109b0fa355.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>指数成分股\u003C\u002Fb>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_863fafbfa771.png\" width=\"30px\"\u002F>\u003Cbr>\u003Cb>数据分析报告\u003C\u002Fb>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n## 先决条件\n\n1. **Python 环境**: Python 3.10+\n2. **依赖管理**: 使用 `uv` 包管理器安装依赖\n3. **数据来源**: 基于 Baostock 数据源，无需付费账号。在此感谢 Baostock。\n4. 提醒：本项目于 Windows 环境下开发。\n\n## 数据更新时间\n\n> 以下是 Baostock 官方数据更新时间，请注意查询最新数据时的时间点 [Baostock 官网](http:\u002F\u002Fbaostock.com\u002Fbaostock\u002Findex.php\u002F%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\u002FLinux\n# source .venv\u002Fbin\u002Factivate\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\", \u002F\u002F 或者 uv.exe 的绝对路径, 例如: \"C:\\\\path\\\\to\\\\uv.exe\"\n      \"args\": [\n        \"--directory\",\n        \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", \u002F\u002F 替换为你的项目根目录绝对路径，不一定是C盘，按实际的填写\n        \"run\",\n        \"python\",\n        \"mcp_server.py\"\n      ],\n      \"transport\": \"stdio\"\n      \u002F\u002F \"workingDirectory\": \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", \u002F\u002F 使用 uv --directory 后，此项可能不再必需，但建议保留作为备用\n    }\n    \u002F\u002F ... other servers ...\n  }\n}\n```\n\n**注意事项:**\n\n- **`command`**: 确保填写的 `uv` 命令或 `uv.exe` 的绝对路径是客户端可以访问和执行的。\n- **`args`**: 确保参数列表完整且顺序正确。\n- **路径转义**: 路径需要写成双反斜杠 `\\\\`。\n  > 这是 Windows 系统特有的情况。如果是在 macOS 或 Linux 系统中，路径使用正斜杠\u002F作为目录分隔符，就不需要这种转义处理。\n- **`workingDirectory`**: 虽然 `uv --directory` 应该能解决工作目录问题，但如果客户端仍然报错 `ModuleNotFoundError`，可以尝试在客户端配置中明确设置此项为项目根目录的绝对路径。\n\n### 方法二：使用 CherryStudio\n\n在 CherryStudio 的 MCP 服务器配置界面中，按如下方式填写：\n\n- **名称**: `a-share-mcp` (或自定义)\n- **描述**: `本地 A 股 MCP 服务器` (或自定义)\n- **类型**: 选择 **标准输入\u002F输出 (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](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_ee1510e7c7c1.png)\n\n![CherryStudio配置示例2](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_97440bc45a97.png)\n\n**重要提示:**\n\n- 确保**命令**字段中的 `uv` 或其绝对路径有效且可执行。\n- 确保**参数**字段按顺序正确填写了五个参数。\n\n## 工具列表\n\n该 MCP 服务器目前提供 **41** 个工具，覆盖股票、财报、宏观、日期分析等全方位数据。以下是完整列表：\n\n\u003Cdiv align=\"center\">\n  \u003Cdetails>\n    \u003Csummary>\u003Cb>🔍 展开查看全部工具\u003C\u002Fb>\u003C\u002Fsummary>\n    \u003Cbr>\n    \u003Ctable>\n      \u003Ctr>\n        \u003Cth>🏛️ 股票市场数据 (Stock)\u003C\u002Fth>\n        \u003Cth>📊 财务报表数据 (Finance)\u003C\u002Fth>\n      \u003C\u002Ftr>\n      \u003Ctr valign=\"top\">\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_historical_k_data\u003C\u002Fcode> (历史K线)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_stock_basic_info\u003C\u002Fcode> (基础信息)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_dividend_data\u003C\u002Fcode> (分红配送)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_adjust_factor_data\u003C\u002Fcode> (复权因子)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_profit_data\u003C\u002Fcode> (盈利能力)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_operation_data\u003C\u002Fcode> (营运能力)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_growth_data\u003C\u002Fcode> (成长能力)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_balance_data\u003C\u002Fcode> (资产负债)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_cash_flow_data\u003C\u002Fcode> (现金流量)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_dupont_data\u003C\u002Fcode> (杜邦分析)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_performance_express_report\u003C\u002Fcode> (业绩快报)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_forecast_report\u003C\u002Fcode> (业绩预告)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_fina_indicator\u003C\u002Fcode> (财务指标汇总)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n      \u003C\u002Ftr>\n      \u003Ctr>\n        \u003Cth>🔎 市场 & 指数 (Market & Index)\u003C\u002Fth>\n        \u003Cth>🌐 宏观 & 其它 (Macro & Utils)\u003C\u002Fth>\n      \u003C\u002Ftr>\n      \u003Ctr valign=\"top\">\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_trade_dates\u003C\u002Fcode> (交易日历)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_all_stock\u003C\u002Fcode> (全市场证券)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>search_stocks\u003C\u002Fcode> (股票搜索)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_suspensions\u003C\u002Fcode> (停牌信息)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_stock_industry\u003C\u002Fcode> (行业分类)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_index_constituents\u003C\u002Fcode> (指数成分)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_sz50_stocks\u003C\u002Fcode> (上证50)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_hs300_stocks\u003C\u002Fcode> (沪深300)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_zz500_stocks\u003C\u002Fcode> (中证500)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>list_industries\u003C\u002Fcode> (行业列表)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_industry_members\u003C\u002Fcode> (行业个股)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n        \u003Ctd>\n          \u003Cul>\n            \u003Cli>\u003Ccode>get_deposit_rate_data\u003C\u002Fcode> (存款利率)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_loan_rate_data\u003C\u002Fcode> (贷款利率)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_required_reserve_ratio_data\u003C\u002Fcode> (存款准备金)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_money_supply_data_month\u003C\u002Fcode> (货币供应月)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_money_supply_data_year\u003C\u002Fcode> (货币供应年)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_latest_trading_date\u003C\u002Fcode> (最新交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_market_analysis_timeframe\u003C\u002Fcode> (智能分析周期)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>is_trading_day\u003C\u002Fcode> (判断交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>previous_trading_day\u003C\u002Fcode> (上一交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>next_trading_day\u003C\u002Fcode> (下一交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_last_n_trading_days\u003C\u002Fcode> (最近N日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_recent_trading_range\u003C\u002Fcode> (近期范围)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_month_end_trading_dates\u003C\u002Fcode> (月末交易日)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>get_stock_analysis\u003C\u002Fcode> (生成分析报告)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>normalize_stock_code\u003C\u002Fcode> (代码标准化)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>normalize_index_code\u003C\u002Fcode> (指数代码标准化)\u003C\u002Fli>\n            \u003Cli>\u003Ccode>list_tool_constants\u003C\u002Fcode> (常量查询)\u003C\u002Fli>\n          \u003C\u002Ful>\n        \u003C\u002Ftd>\n      \u003C\u002Ftr>\n    \u003C\u002Ftable>\n  \u003C\u002Fdetails>\n\u003C\u002Fdiv>\n\n## 贡献指南\n\n欢迎提交 Issue 或 Pull Request 来帮助改进项目。贡献前请先查看现有 Issue 和文档。\n\n## ☕️ 请作者喝杯咖啡\n\n如果这个项目对你有帮助，欢迎请我喝杯咖啡 ❤️\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_4b130a28c11e.png\" alt=\"支付宝收款码\" width=\"300\"\u002F>\n\n## 许可证\n\n本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_readme_24ddebb9ab59.png\" \u002F>\n\u003C\u002Fdiv>\n\n## 本次更新概览（2025-12-25）\n\n本次更新新增 **财务指标汇总工具**，将 6 大类财务数据聚合为一个便捷查询接口。\n\n### 🆕 新增工具\n\n- **财务指标汇总**: `get_fina_indicator` 一键获取 6 大类财务指标（盈利能力、营运能力、成长能力、偿债能力、现金流量、杜邦分析），按季度返回合并数据。","# a-share-mcp 快速上手指南\n\n本项目是一个基于 Model Context Protocol (MCP) 的 A 股数据服务器，提供股票基础信息、历史 K 线、财务报表及宏观经济等全方位数据查询功能。数据源采用免费的 Baostock，无需付费账号。\n\n## 1. 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: Windows (项目主要开发环境), macOS, Linux\n*   **Python 版本**: Python 3.10+ (推荐 3.12+)\n*   **包管理器**: `uv` (高性能 Python 包管理工具)\n    *   安装 uv (官方脚本):\n        ```bash\n        curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n        ```\n    *   或 Windows PowerShell:\n        ```powershell\n        powershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n        ```\n\n## 2. 安装步骤\n\n请在项目根目录下执行以下命令来配置运行环境：\n\n```bash\n# 1. 创建虚拟环境\nuv venv\n\n# 2. 激活虚拟环境\n# Windows 系统\n.venv\\Scripts\\activate\n# macOS \u002F Linux 系统\nsource .venv\u002Fbin\u002Factivate\n\n# 3. 安装项目依赖\nuv sync\n```\n\n## 3. 基本使用\n\n本工具需作为 MCP Server 在支持 MCP 协议的客户端（如 Cursor, VS Code, CherryStudio 等）中配置使用。\n\n### 配置方式一：JSON 配置文件 (适用于 Cursor, VS Code, Trae 等)\n\n在客户端的 MCP 配置文件中添加以下条目。**注意替换 `args` 中的绝对路径为您本地的项目实际路径**。\n\n```json\n{\n  \"mcpServers\": {\n    \"a-share-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"C:\\\\Users\\\\YourName\\\\Projects\\\\a_share_mcp\", \n        \"run\",\n        \"python\",\n        \"mcp_server.py\"\n      ],\n      \"transport\": \"stdio\"\n    }\n  }\n}\n```\n\n> **注意**：Windows 路径需使用双反斜杠 `\\\\` 转义；macOS\u002FLinux 使用正斜杠 `\u002F`。\n\n### 配置方式二：CherryStudio 图形界面\n\n如果您使用 CherryStudio，请在 MCP 服务器设置界面按以下参数填写：\n\n*   **名称**: `a-share-mcp`\n*   **类型**: `标准输入\u002F输出 (stdio)`\n*   **命令**: `uv` (若未配置环境变量，请填写 `uv.exe` 的绝对路径)\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配置成功并重启客户端后，您可以在对话框中直接询问 A 股相关问题，例如：\n\n*   “查询贵州茅台最近一年的历史 K 线数据。”\n*   “展示沪深 300 指数的成分股列表。”\n*   “分析宁德时代最新的财务报表和盈利能力指标。”\n*   “获取当前的存款准备金率和货币供应量数据。”\n\n服务器将自动调用对应的 41 个工具（如 `get_historical_k_data`, `get_profit_data` 等）返回结构化数据和分析结果。","一位量化交易爱好者正试图让 AI 助手分析“贵州茅台”过去三年的财务趋势，并结合宏观利率数据给出投资建议。\n\n### 没有 a-share-mcp-is-just-i-need 时\n- **数据获取割裂**：用户需手动在东方财富、同花顺等多个网站复制粘贴股价和财报数据，过程繁琐且容易出错。\n- **时效性差**：AI 模型因训练数据截止限制，无法获取最新的 A 股实时行情或刚刚发布的季度报告，只能提供过时信息。\n- **上下文断裂**：用户必须将整理好的长段数据反复投喂给 AI，不仅消耗大量 Token，还容易超出上下文窗口导致分析中断。\n- **宏观关联弱**：难以将个股表现与实时的宏观经济指标（如 M2 增速、LPR 利率）进行自动关联分析，依赖人工查找对比。\n\n### 使用 a-share-mcp-is-just-i-need 后\n- **一键自动调用**：AI 直接通过 MCP 协议调用工具，瞬间拉取“贵州茅台”的历史 K 线、财务报表及最新公告，无需人工干预。\n- **实时数据支撑**：直接连接 Baostock 等数据源，确保分析基于今日最新的盘面数据和刚披露的财务指标，消除信息滞后。\n- **流式精准分析**：AI 按需动态获取数据字段，仅在需要时读取关键指标，大幅节省 Token 并保持对话上下文的连贯性。\n- **多维深度洞察**：自动联动宏观经济工具，将个股走势与当前利率环境、大盘指数进行交叉验证，生成逻辑严密的综合研报。\n\na-share-mcp-is-just-i-need 将分散的 A 股数据转化为 AI 可即时调用的原生能力，让投资决策从“人工搜集 + 粗略估算”升级为“实时数据驱动的深度智能分析”。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002F24mlight_a-share-mcp-is-just-i-need_ee1510e7.png","24mlight","Devin","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002F24mlight_e980742e.jpg","Entities should not be multiplied unnecessarily.","https:\u002F\u002Fgithub.com\u002F24mlight",[79],{"name":80,"color":81,"percentage":82},"Python","#3572A5",100,641,108,"2026-04-14T07:56:22","MIT","Windows, macOS, Linux","未说明",{"notes":90,"python":91,"dependencies":92},"本项目在 Windows 环境下开发，但支持跨平台运行。必须使用 'uv' 包管理器进行依赖安装和环境管理。数据源基于 Baostock，无需付费账号，但需注意其官方数据更新时间（如交易日 17:30 后更新日 K 线）。配置 MCP 客户端时需正确设置 uv 命令路径及项目绝对路径。","3.10+",[93,94],"uv","baostock",[13,45],"2026-03-27T02:49:30.150509","2026-04-17T09:54:11.784865",[99,104,108,113,117,121],{"id":100,"question_zh":101,"answer_zh":102,"source_url":103},37197,"调用接口成功但没有返回数据，或者查询不到最新日期的数据怎么办？","这通常是因为底层数据源（如 baostock）存在约半天的数据延迟，导致无法查询到当天或最近一天的实时数据。目前建议等待数据源更新，或者尝试替换其他数据源来解决此问题。","https:\u002F\u002Fgithub.com\u002F24mlight\u002Fa-share-mcp-is-just-i-need\u002Fissues\u002F1",{"id":105,"question_zh":106,"answer_zh":107,"source_url":103},37198,"运行时报错提示缺少 'tabulate' 模块，应该如何修复？","需要在项目环境中安装缺失的依赖包。请执行命令：uv add tabulate。如果之前是通过 git 更新的代码，确保在更新后重新同步依赖。",{"id":109,"question_zh":110,"answer_zh":111,"source_url":112},37199,"如何在 Linux 服务器上部署 A 股 MCP Server 并通过 Windows 本地的 VSCode + Cline 连接？","跨平台连接（Linux 服务端 + Windows 客户端）可能会遇到兼容性问题导致连接失败。建议的解决方案是直接将 a-share-mcp server 安装在 Windows 机器上，然后使用本地的 VSCode + Cline 进行连接，这样可以确保体验顺畅且连接成功。","https:\u002F\u002Fgithub.com\u002F24mlight\u002Fa-share-mcp-is-just-i-need\u002Fissues\u002F7",{"id":114,"question_zh":115,"answer_zh":116,"source_url":112},37200,"在 Linux\u002FmacOS 环境下如何正确创建虚拟环境并安装依赖？","请按照以下步骤操作：\n1. 创建虚拟环境：uv venv\n2. 激活虚拟环境：source .venv\u002Fbin\u002Factivate\n3. 安装所有依赖（必须在激活状态下执行）：uv sync",{"id":118,"question_zh":119,"answer_zh":120,"source_url":112},37201,"在 Windows 环境下如何正确创建虚拟环境并安装依赖？","请按照以下步骤操作：\n1. 创建虚拟环境：uv venv\n2. 激活虚拟环境：.venv\\Scripts\\activate\n3. 安装所有依赖（必须在激活状态下执行）：uv sync",{"id":122,"question_zh":123,"answer_zh":124,"source_url":112},37202,"VSCode + Cline 配置 JSON 后连接 MCP Server 失败，常见原因是什么？","如果配置文件无误但连接失败，常见原因是服务端与客户端操作系统不一致导致的兼容性问题（例如服务端在 Linux，客户端在 Windows）。建议将服务端部署在与客户端相同的操作系统（如都使用 Windows）上进行测试。",[]]