AI导哈

股票数据服务

一个强大的MCP服务器，用于访问印度国家证券交易所（NSE）数据、金融洞察和高级股票筛选。

  • by JAY-MU-4098
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 JAY-MU-4098/nse-mcp-server

使用说明

🚀 NSE MCP服务器

⚡ 由...驱动 uv + pyproject.toml 适用于现代、快速和可重复的Python环境

一个强大的MCP（模型上下文协议）服务器，用于访问NSE（印度国家证券交易所）数据、财务见解和高级股票筛选。

🔗 github：https://github.com/JAY-MU-4098/nse-mcp-server

🔗 领英：https://www.linkedin.com/in/jay-gogra-108991237/

📌 特性

📊 市场数据

  • 实时股价
  • 符号信息
  • 市场现状
  • 所有NSE指数
  • 指数特定数据

📈 选项和F&O

  • 期权链数据
  • 有效期
  • F&O库存清单

📉 历史和交易见解

  • 历史价格数据（多个区间）
  • 交货历史
  • 内幕交易数据
  • 质押股份数据
  • SAST披露

🔍 筛分机发动机

  • 基于查询的自定义筛选器
  • AND/OR逻辑支持
  • 操作员： gt, lt, eq, between, in
  • 预定义筛选器：
    • 顶级赢家
    • 顶级失败者
    • 被低估的股票
    • 成长型股票
    • 顶级共同基金

🏢 财务数据

  • 财务报表
  • 资产负债表数据
  • ESG得分
  • 公司简介

📊 分析与洞察

  • 分析师建议
  • 收益日历
  • 盈利预测
  • 持股数据

📰 附加数据

  • 股票新闻
  • 内幕活动
  • 公司行为

🧠 为什么是这个项目？

大多数与NSE相关的工具是：

  • 对开发人员不友好
  • 灵活性有限
  • AI尚未就绪

该项目旨在提供：

  • 基于清洁MCP的API抽象
  • AI代理兼容性
  • 可扩展架构
  • 统一访问多个数据源

⚙️ 安装（uv+pyproject.toml）

此项目使用 uv 用于超快速的依赖关系管理。

1.️⃣ 安装uv

pip install uv

2.️⃣ 克隆仓库

git clone https://github.com/JAY-MU-4098/nse-mcp-server.git
cd nse-mcp-server

3.️⃣ 创建虚拟环境

uv venv
source .venv/bin/activate   # Linux / Mac
# .venv\Scripts\activate    # Windows

4.️⃣ 安装依赖项

uv sync

🚀 运行服务器

# if you want it as api
python app/main.py

📁 项目结构

nse-mcp-server/
│── app/
│   ├── main.py              # FastAPI entry point
│   ├── mcp_server.py       # MCP server logic
│   ├── tools.py            # Tool definitions
│   ├── utils/
│   │   ├── pnsea_lib.py
│   │   ├── pnsea_nse_client.py
│   │   ├── yfinance_lib.py
│   │   └── yfinance_screnner.py
│   └── test_mcp.py
│
│── pyproject.toml
│── uv.lock
│── README.md

🧠 MCP使用

您可以将此服务器与MCP兼容的客户端连接，例如：

  • 克劳德桌面
  • 自定义AI代理
  • 自动化工具
result = await client.call_tool("get_current_price", {"symbol": "RELIANCE"})

result = await client.call_tool(
    "run_screener",
    {
        "screener_type": "equity",
        "query_dict": {
            "and": [
                {"field": "pe", "op": "lt", "value": 8},
                {"field": "priceToBook", "op": "lt", "value": 3}
            ]
        },
        "index": "NIFTY"
    }
)

🔧 克劳德桌面MCP配置

  • 打开claude桌面，进入设置>开发人员>编辑配置JSON
for web base usage 
{
  "mcpServers": {
    "nse-mcp-server": {
      "transport": "http",
      "url": "http://127.0.0.1:8001/mcp",
    }
  }
}

for local STDIO base usage
- Update 1 line in mcp_server.py 
    server.run(transport="http", host="0.0.0.0", port=8001) from to
    server.run()

{
  "mcpServers": {
    "nse-mcp-server": {
      "transport": "stdio",
      "command": "path/to/uv",
      "args": ["run", "path/to/app/mcp_server.py"]
    }
  }
}
  • 重新启动克劳德

🧩 用例

  • AI交易助理
  • Algo交易系统
  • 股票筛选
  • 金融API
  • 研究工具

相关 MCP