elsejj/mcp-cn-a-stock

这是一个为大模型提供 A 股数据的的 MCP(Model Content Protocol) 服务。
目前股票数据为大模型提供以下的数据
基本信息：包括股票名称，所属板块等
行情数据：当前的行情，以及相关可供参考的历史统计
财务数据：近年的公司主要财务数据
技术指标：若干常用技术指标
这些数据，被划分成三个工具
brief: 给定股票的基本信息，行情数据
medium: 提供所有基本数据和一些财务数据
full: 提供所有中等数据和技术指标
由大模型根据用户的问题需要，自行选择调用。
## 免责申明
本项目会尽可能的保障准确可用, 但不对因此产生的任何后果负任何责任, 使用本 MCP 即代表接受此免责申明.
# 使用方法
由于股票的数据比较庞大，所以我们提供了一个公开的服务地址, 查看 tests/test.sh 文件，里面有一些测试用例以及相关的使用方法。
然后需要一个 MCP 客户端来连接这个服务，下面是一些常用的 MCP 客户端的配置方法。
## 重要更新 2025-11-22
更新 MCP 协议为 streamable-http, 测试服务地址变更为
http://82.156.17.205/cnstock/mcp
## 部署自己的实例
### 数据库
目前使用 msd 作为数据库, 这是一个专为金融时序数据设计的数据库, 高效且易用
下载 msd 后, 将其加入 $PATH
在 db 目录中, 运行 start.sh 来启动数据库
如果使用其它数据库, 请自行调整 datafeed.py 来获取原始数据
### 数据准备
参考 create.sql, 准备以下的数据
日线: 参考 stockkline1d.csv
分红送配: 计算分红送配 stockdividend.csv
股本: 参考 stockshares.csv
财务指标: 参考 stockfinancial.csv
资金流向: 参考 stockcapitalflow.csv
示例数据可以在 db 目录中, 通过 msd shell sql/importsample.sql 来导入
### 因子计算
目前使用 py-alpha-lib 作为因子计算库
如果使用其它因子库, 请自行调整 indicators.py 来实现因子计算
### 启动服务
准备好数据库后, 创建 .env 文件, 设置 MSDHOST=http://localhost:50510, 让 qtf-mcp 知道数据库的位置
运行 uv run main.py --transport=http 来启动服务
默认的服务地址是 http://localhost:8000/mcp, 端口可以通过 --port 来指定
## CherryStudio
CherryStudio 是一个支持 MCP 的客户端，提供了用户友好的界面和丰富的功能。
### 配置
配置路径为
> 左侧栏 -> 设置 -> MCP 设置 -> 添加服务器
在弹出的对话框中, 参考下图填入相关的信息
然后启用即可
### 使用
## DeepChat
DeepChat 是一个支持 MCP 的客户端，提供了用户友好的界面和丰富的功能。
### 配置
配置路径为
> 左侧栏 -> 设置 -> MCP 服务器 -> 添加服务器
在弹出的对话框中, 参考下图填入相关的信息
然后启用即可
### 使用
# 使用案例
## 盘面分析
### 系统题词
你是一个专业的投资顾问，请根据用户的输入，推断出股票代码，然后调用相关的工具，进行走势分析。
请在分析时标明当前的数据日期
你应该应用你的金融学知识，着重对数据进行专业解读。
### 用户输入
浦发银行
### 模型回复
markdown
好的，我将为您分析浦发银行的股票走势。浦发银行的股票代码为 SH600000（上海证券交易所上市）。我将调用相关工具获取最新的数据并进行分析。
# 浦发银行 (SH600000) 股票走势分析
数据日期：2025 年 5 月 6 日
以下是对浦发银行 (SH600000) 的详细分析，基于提供的最新数据，结合金融学知识，从基本面、交易数据、技术指标等多个角度进行解读。
## 1. 基本面分析
行业概念：浦发银行属于信托概念、证金持股、跨境支付(CIPS) 和高股息精选等概念板块。这些标签表明其在金融领域具有多元化业务布局，尤其是在高股息领域，可能对追求稳定收益的投资者具有吸引力。
市盈率 (PE)：4.90，处于较低水平，表明股票估值相对较低，可能被市场低估，但也可能反映市场对其未来增长预期的悲观。
市净率 (PB)：0.33，远低于 1，表明股价低于每股净资产，可能是价值投资的机会，但也可能反映资产质量或盈利能力问题。
净资产收益率 (ROE)：2.65%，相对较低，显示公司资本利用效率不高，盈利能力有待提升。
### 财务数据趋势
从过去五年的财务数据来看：
主营收入：2020 年至 2022 年呈下降趋势，2023 年略有回升，但 2024 年再次小幅下降至 1707.48 亿元，显示业务增长乏力。
净利润：2020 年至 2022 年持续下降，2023 年有所回升至 367.02 亿元，2024 年进一步增长至 452.57 亿元，表明盈利能力正在逐步恢复。
每股收益 (EPS) 和 每股净资产 (NAV)：EPS 从 2020 年的 1.88 元下降至 2023 年的 1.07 元，2024 年回升至 1.36 元；NAV 持续增长，2024 年达到 22.36 元，显示公司资产积累能力较强。
净资产收益率 (ROE)：从 2020 年的 10.46%下降至 2023 年的 5.10%，2024 年小幅回升至 6.08%，反映出盈利效率仍未恢复到前期水平。
基本面总结：浦发银行目前估值较低，具有一定的价值投资潜力，但盈利能力和业务增长面临挑战。净利润的回升是一个积极信号，但主营收入的波动和较低的 ROE 表明其长期增长仍需观察。
## 2. 交易数据分析
### 价格趋势
短期 (5 日)：均价 10.858 元，最高 11.190 元，最低 10.570 元，累计涨跌幅+5.48%，显示短期内股价有较强的上涨动能。
中期 (20 日)：均价 10.510 元，累计涨跌幅+6.58%，价格波动范围较大（最高 11.190 元，最低 9.460 元），表明中期趋势向上，但波动性较高。
长期 (240 日)：均价 9.468 元，累计涨跌幅+43.21%，显示长期趋势非常强劲，股价从低点 7.760 元上涨至当前水平，反映市场对该股的信心逐步增强。
### 成交量与换手率
成交量：当日成交量 97.26 万手，显著高于 5 日均量（67.21 万手）和 20 日均量（69.60 万手），表明近期市场参与度增加，资金流入明显。
换手率：当日换手率 0.33%，5 日总换手率 1.14%，20 日总换手率 4.74%，显示短期交易活跃度较高，但长期来看换手率较低（240 日均换手 0.17%），投资者多以持有为主。
### 振幅
短期 (5 日)：振幅 5.87%，显示短期波动较为温和。
长期 (240 日)：振幅 44.20%，表明长期内价格波动较大，投资者需关注风险。
交易数据总结：浦发银行近期价格呈上涨趋势，尤其是短期和中期动能较强，成交量放大显示资金关注度提升。然而，长期振幅较大，投资者需警惕价格回调风险。
## 3. 技术指标分析
### KDJ 指标
最新数据 (2025-05-06)：K=86.38，D=81.30，J=96.54，处于高位，显示股价短期内处于超买状态，可能面临回调压力。
趋势：过去 30 日 KDJ 指标整体呈上升趋势，J 值多次超过 100，反映市场情绪较为乐观，但需警惕超买风险。