内容
# 印度国家证券交易所 (NSEI) MCP 服务器
一个模型上下文协议 (MCP) 服务器，通过标准化接口提供对 NSEI 交易数据的访问。该服务器允许像 Claude 这样的 AI 助手以编程方式访问金融数据。
## 特性
- **获取涨幅前列股票**：访问在任何给定时间段内的涨幅前列股票——涨幅和跌幅（目前限制为最多 3 个月的间隔）
- **获取最新交易**：检索当天交易的最新数据以进行进一步分析
## 安装
### 先决条件
- Python 3.8 或更高版本
- UV 包管理器（推荐）或 pip
- Financial Modeling Prep API 密钥
### 设置
1. 克隆此代码库
2. 使用 UV 安装依赖（推荐）：
```bash
uv venv
uv pip install -r requirements.txt
```
或使用 pip：
```bash
pip install -r requirements.txt
```
## 运行服务器
### 使用 UV（推荐）
UV 提供更快的依赖解析和安装。要使用 UV 运行服务器：
```bash
# 激活虚拟环境
uv venv activate
# 运行服务器
python nsei_mcp_server.py
```
服务器将启动并在默认的 MCP 端口上监听连接。
### 使用 pip
```bash
# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate # 在 Windows 上: venv\Scripts\activate
# 运行服务器
python fmp_mcp_server.py
```
## 与 Claude Desktop 连接
Claude Desktop 可以连接到 MCP 服务器以访问金融数据。以下是设置方法：
1. 下载 Claude Desktop
2. 如果您正在从前面的步骤运行服务器，可以关闭它，因为 Claude Desktop 会自行启动一个本地服务器。
3. 编辑 claude_desktop_config.json：
```
"fmp_mcp_server": {
"command": "uv",
"args": [
"--directory",
"将此替换为代码库的绝对目录",
"run",
"fmp_mcp_server.py"]
}
```
现在 Claude 可以通过 MCP 接口使用 FMP 数据。您可以询问 Claude：
- 获取当天 NSE 的涨幅前列股票
- 检索特定股票的交易——“RIL 今天表现如何？”
- 还有更多！
## Claude 的示例查询
连接后，您可以向 Claude 提问，例如：
- “今天 SBI 的股票表现如何？”
- “今天 RIL 是否在涨幅前列？”
- “在今天的股票市场交易中，找出按百分比计算的最大跌幅股票”
## 缓存
将在未来版本中实现
## 日志记录
日志将写入 `logs` 目录，并启用轮换：
- 最大日志文件大小：10MB
- 备份文件数量：5
## 许可证
[MIT 许可证](LICENSE)
## 致谢
- [Shadi Copty 的 FMP MCP 服务器](https://github.com/shadi-fsai/fmp_mcp_server) 提供 API
- [MCP 服务器快速入门指南](https://modelcontextprotocol.io/quickstart/server) 用于模型上下文协议快速入门指南的实现
MCP 市场