Angel One Stock Analysis

MCPAI代理

提供方 dineshratn

AI代理 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个用于实时股票市场分析的模型上下文协议(MCP)服务器,支持10多种免费股票市场API,包括Yahoo Finance、Alpha Vantage等,适用于印度股票(NSE/BSE)和全球市场分析。

一句话选型结论

按资料字段整理

Angel One Stock Analysis 属于AI代理类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

股票分析Python本地部署实时数据投资组合分析MCP集成Docker支持

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Angel One Stock Analysis当前 4 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方dineshratn上游标注的维护方 dineshratn
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.0 KB
来自项目仓库与上游目录的原文,未做删改

股票分析MCP服务器

使用Claude Desktop进行实时股票市场分析的模型上下文协议(MCP)服务器。支持 10+免费股市API 包括雅虎财经、阿尔法Vantage、Twelve Data、Finnhub等。非常适合分析印度股市(NSE/BSE)和全球市场。

🌟 特性

  • 多个免费API:从10多家免费股票市场数据提供商中选择
  • 不需要API密钥:与雅虎财经一起开箱即用(默认)
  • 实时市场数据:实时股票价格、报价和市场数据
  • 历史数据:访问历史蜡烛数据进行技术分析
  • 印度ETF追踪:追踪17只以上受欢迎的印度ETF的实时价格⭐ 新
  • PostgreSQL存储:通过Supabase实现持久数据库存储
  • 投资组合分析:基于市盈率和股息收益率的人工智能投资组合分配
  • MCP集成:与Claude Desktop无缝集成
  • Docker支持:容器化部署以实现一致性
  • API回退:如果主API失败,则自动回退到替代API

📊 支持的API

API 免费层 API密钥 最适合
雅虎财经 ⭐ 无限制 ❌ 否 通用(默认)
阿尔法Vantage 每天25次 ✅ 是 技术指标
十二个数据 800/天 ✅ 是 实时数据
Finnhub 60/分钟 ✅ 是 新闻和情绪
NSE印度 各不相同 ❌ 否 印度股票(NSE)
IEX云 50k/月 ✅ 是 美国基本面
Polygon.io 5/分钟 ✅ 是 高质量的美国数据
市场堆栈 每月100个 ✅ 是 全球覆盖

看 FREE_STOC_APIS.md 查看完整列表和详细信息

📋 先决条件

  1. 数据库:Supabase帐户(可用免费层)或PostgreSQL
  2. 码头工人 (可选):用于容器化部署
  3. 克劳德桌面:已安装最新版本
  4. API密钥 (可选):仅当您想使用雅虎财经以外的API时

🚀 快速启动(不需要API密钥!)

步骤1:获取数据库(Supabase)

  1. 注册Supabase (免费):https://supabase.com/
  2. 创建新项目
  3. 获取您的DATABASE_URL:
    - 转到项目设置>数据库
    - 复制“连接字符串”(URI格式)

步骤2:配置环境

  1. 复制示例环境文件:```bash
    cp .env.example .env

2. 编辑 `.env` 并添加您的数据库URL:```env
# Required: Database
DATABASE_URL=postgresql://postgres:yourpassword@db.xxx.supabase.co:5432/postgres

# Optional: Choose API provider (default: yfinance - no key needed)
STOCK_API_PROVIDER=yfinance

就是这样!雅虎金融(默认提供商)不需要API密钥

步骤3:安装依赖项(如果在本地运行)```bash

pip install -r requirements.txt


### 步骤4:测试设置```bash
# Test API providers
python test_api_providers.py

# Analyze stocks
python analyze_all_stocks.py

🔑 使用其他API(可选)

想要使用不同的API吗?方法如下:

选项1:Alpha Vantage(每天25次通话)```bash

1. Get free API key: https://www.alphavantage.co/support/#api-key

2. Add to .env:

ALPHAVANTAGE_API_KEY=your_key_here
STOCK_API_PROVIDER=alphavantage


### 选项2:12次数据(800次通话/天)```bash
# 1. Get free API key: https://twelvedata.com/pricing
# 2. Add to .env:
TWELVEDATA_API_KEY=your_key_here
STOCK_API_PROVIDER=twelvedata

选项3:Finnhub(60次通话/分钟)```bash

1. Get free API key: https://finnhub.io/register

2. Add to .env:

FINNHUB_API_KEY=your_key_here
STOCK_API_PROVIDER=finnhub


**看 FREE_STOC_APIS.md 适用于所有10+API选项!**

______________________________________________________________________

## 📊 印度ETF追踪

追踪17种以上受欢迎的印度ETF(交易所交易基金)的价格:```bash
# Run ETF tracker
python indian_etfs.py

# Output: Live prices, category analysis, top performers, value picks
# Exports to CSV automatically

追踪的ETF:

  • 股票ETF: Nifty 50,Nifty Next 50,Nift 100,Sensex
  • 行业ETF: 银行、IT、PSU银行
  • 黄金ETF: 多个黄金追踪基金
  • 流动性ETF: 现金管理和应急基金
  • 国际: 恒生(香港市场)
  • 符合伊斯兰教法: 虔诚的伊斯兰教法

特征:

  • ✅ 实时资产净值价格
  • ✅ 52周高/低跟踪
  • ✅ 交易量和资产管理规模数据
  • ✅ 费用比率比较
  • ✅ 分类分析
  • ✅ CSV导出以供进一步分析

看 印度_ETFS.md 获取完整的ETF列表和投资策略!


🐳 Docker设置

步骤3:构建Docker镜像```bash

Build the image

docker build -t angel-one-stock-analysis .

Verify the build

docker images | grep angel-one


### 步骤4:配置Claude桌面

1. **查找您的Claude Desktop配置文件**:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- 窗户: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

1. **添加MCP服务器配置**:```json
{
"mcpServers": {
"angel-one-stocks": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/absolute/path/to/project/src/database:/app/src/database",
"--env-file",
"/absolute/path/to/project/.env",
"angel-one-stock-analysis"
]
}
}
}

重要:替换 /absolute/path/to/project 带有此项目目录的实际路径!

步骤5:测试设置

  1. 重新启动克劳德桌面

  2. 检查MCP工具:您应该在Claude的工具菜单中看到Angel One工具:

  • get_table_overview
  • query_database
  • refresh_market_data
  • get_historical_data

🎮 用法示例

配置后,您可以向Claude提出以下问题:

基本查询```

"Show me the schema of the stock database"
"Refresh the market data"
"Show me all available stocks"


### 市场分析```
"Which stocks have volume greater than 1 million today?"
"Show me the top 10 stocks by price"
"Find stocks with price between 100 and 500"

历史数据```

"Get me 5-minute candle data for SBIN-EQ for today"
"Fetch historical data for Reliance from last week"


### 高级分析```
"Analyze the market trends and show me high-volume stocks"
"Compare the performance of banking stocks"
"Find stocks that hit upper circuit today"

📁 项目结构```

angel-one-stock-analysis/
├── Dockerfile # Docker configuration
├── pyproject.toml # Python dependencies
├── .env.example # Example environment variables
├── README.md # This file
└── src/
├── stock_analysis/
│ ├── init.py
│ ├── main.py # MCP server implementation
│ └── constant_parameters.py # Configuration constants
└── database/
└── YYYY-MM-DD.db # Daily SQLite databases


## 🔧 可用的MCP工具

### 1. `get_table_overview()`

返回数据库架构和示例数据。

### 2. `query_database(sql_query: str)`

在股票数据库上执行SELECT查询。

**示例**:```sql
SELECT trading_symbol, last_price, volume
FROM stock_data
WHERE volume > 1000000
ORDER BY volume DESC
LIMIT 10;

3. refresh_market_data()

强制刷新Angel One API的市场数据。

4. get_historical_data(symbol_token, exchange, interval, from_date, to_date)

获取历史蜡烛数据。

参数:

  • symbol_token:来自凭证主控的令牌ID
  • exchange:“NSE”、“BSE”、“NFO”等。
  • interval:“一分钟”、“五分钟”和“一天”等。
  • from_date: "2024-01-01 09:15"
  • to_date: "2024-01-01 15:30"

🔒 安全说明

  1. 永远不要承诺你的 .env 文件 到版本控制
  2. 确保API密钥的安全 -不要分享
  3. 使用卷装载 将数据库持久化到容器外
  4. 定期按键轮换 建议用于生产

🐛 故障排除

常见问题

1.身份验证失败

  • 在中验证您的凭据 .env
  • 检查TOTP令牌是否正确
  • 确保您的Angel One帐户处于活动状态

2.找不到数据库

  • 数据库是在首次数据提取时创建的
  • 使用 refresh_market_data() 强制数据提取
  • 检查Docker配置中的卷挂载路径

3.速率限制错误

  • Angel One对API呼叫有费率限制
  • 该代码包括处理此问题的延迟
  • 尝试减少代码中的批处理大小

4.Docker批量问题

  • 确保数据库路径存在
  • 检查Docker是否有权限写入该目录
  • 在Docker配置中使用绝对路径

调试模式

通过修改启用调试日志记录 main.py:```python
logging.basicConfig(level=logging.DEBUG)


## 📊 数据库模式```sql
CREATE TABLE stock_data (
symbol_token TEXT PRIMARY KEY,
trading_symbol TEXT,
name TEXT,
exchange TEXT,
instrument_type TEXT,
last_price REAL,
open_price REAL,
high_price REAL,
low_price REAL,
close_price REAL,
volume INTEGER,
week_high_52 REAL,
week_low_52 REAL,
upper_circuit REAL,
lower_circuit REAL,
expiry DATE,
strike_price REAL,
lot_size INTEGER,
tick_size REAL,
last_updated TIMESTAMP
)

🔄 定制

筛选不同股票

编辑 constant_parameters.py:```python

Change STOCK_FILTER to:

STOCK_FILTER = "NIFTY 100" # For Nifty 100 stocks
STOCK_FILTER = "NIFTY 500" # For Nifty 500 stocks
STOCK_FILTER = None # For all NSE stocks
```

添加技术指标

您可以扩展 scrape_data() 使用以下库计算和存储技术指标的功能 ta-lib 或 pandas-ta.

修改间隔

在中更改默认蜡烛间隔 constant_parameters.py.

📚 参考文献

  • Angel One SmartAPI文档
  • SmartAPI Python SDK
  • MCP协议文件
  • 原始TradingView文章

📝 许可证

这个项目是为了教育目的。请查看Angel One的API商业使用服务条款。

🤝 贡献

请随时打开问题或提交改进请求!

⚠️ 免责声明

此工具仅供参考。股票交易涉及风险。在做出投资决策之前,请进行自己的研究并咨询财务顾问。开发商不对任何交易损失负责。

📧 支持

对于Angel One API问题: SmartAPI支持论坛

对于MCP问题:请查看MCP文档或Claude Desktop支持


交易愉快! 📈💚

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Angel One Stock Analysis 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Angel One Stock Analysis 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Angel One Stock Analysis 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Angel One Stock Analysis 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Angel One Stock Analysis 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Angel One Stock Analysis 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 金融数据、Python、Claude、Docker支持。具体工具清单以官方文档为准。

Angel One Stock Analysis 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Angel One Stock Analysis 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。