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
• 研究工具