Mcp Stocks Info Server

🚀 MOEX 股票及新闻 MCP 服务器

MCP（模型上下文协议）服务器用于访问莫斯科交易所（MOEX）的股票行情数据和金融新闻。通过该服务器提供的接口，可与大型语言模型（LLM）交互，获取实时行情信息和新闻。

🚀 快速开始

本 MCP 服务器能帮助你轻松获取 MOEX 的股票行情和金融新闻，下面为你介绍如何快速开启使用之旅。

✨ 主要特性

• 丰富的数据获取功能：可获取 MOEX 上市股票的行情信息，查看涨幅排行（top gainers）、跌幅排行（top losers），按名称或代码搜索股票，获取当天金融新闻，搜索关键词相关的新闻，还能根据股票代码获取相关新闻。
• 支持与 LLM 交互：遵循 MCP 协议，提供多种工具（tools）和提示模板（prompts），方便与大型语言模型进行交互。
• 灵活的缓存机制：集成缓存机制，默认存储时间设置灵活。
• 可配置数据库：可配置 MongoDB 和 Redis 数据库。
• 多数据接口支持：支持 MOEX 和 NewsAPI 的数据接口。

📦 安装指南

安装要求

• 基础依赖：需要安装 Go 语言开发环境。
• 第三方服务：需使用 MongoDB、Redis、MOEX API、NewsAPI，配置文件中要提供各接口的访问凭证。

安装步骤

1. 克隆代码仓库：

git clone https://github.com/JkLondon/mcp-stocks-info-server.git

2. 搭建本地数据库环境：
   • MongoDB：运行 mongod --dbpath=/data/db。
   • Redis：启动服务并监听 6379 端口。
3. 配置项目：编辑配置文件，填写各模块的连接信息和 API 密钥。
4. 启动服务：

go run main.go

🔧 技术细节

数据库配置示例：

database:
uri: "mongodb://localhost:27017"
database: "mcp_stocks"
collection: "stocks"
timeout: "5s"

缓存配置示例：

cache:
redisURI: "localhost:6379"
redisDB: 0
defaultTTL: "5m"
stocksTTL: "15m"
newsTTL: "30m"

💻 使用示例

基础用法

本项目提供了丰富的工具和提示模板来与 LLM 交互，以下是一些基础的使用示例。

可用工具：

• get_stock_info：获取股票行情信息
• get_top_gainers：查看涨幅排行
• get_top_losers：查看跌幅排行
• search_stocks：按名称或代码搜索股票
• get_today_news：获取当天新闻
• search_news：关键词搜索新闻
• get_news_by_ticker：根据股票代码获取相关新闻

可用提示模板：

• stock_analysis：分析个股行情
• market_overview：市场整体概览
• news_analysis：解读当天重要新闻

🤝 如何参与开发

项目开源，欢迎任何开发者参与。请通过提交 issue 或 pull request 贡献代码。

📄 许可证

本项目采用 MIT 许可证。