MCP Stocks Info Server

🚀 MOEX 股票及新聞 MCP 服務器

MCP（模型上下文協議）服務器可用於訪問莫斯科交易所（MOEX）的股票行情數據和金融新聞。它提供了與大型語言模型（LLM）交互的接口，能夠幫助用戶獲取即時行情信息和新聞。

🚀 快速開始

MCP 服務器為你提供了訪問莫斯科交易所股票行情數據和金融新聞的便捷途徑。通過與大型語言模型交互，你可以輕鬆獲取所需的即時信息。

✨ 主要特性

• 豐富的數據獲取：可獲取 MOEX 上市股票的行情信息，查看漲幅排行（top gainers）和跌幅排行（top losers），還能按名稱或代碼搜索股票。
• 新聞資訊支持：能獲取當天金融新聞，支持搜索關鍵詞相關的新聞，也可根據股票代碼獲取相關新聞。
• LLM 交互友好：支持與 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

項目提供多種工具（tools）和提示模板（prompts），方便與 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：解讀當天重要新聞

💻 使用示例

基礎用法

若要獲取股票行情信息，可使用 get_stock_info 工具，在與 LLM 交互時調用該工具即可。

高級用法

若要進行個股行情分析，可使用 stock_analysis 提示模板，結合相關工具獲取的數據進行分析。

🤝 如何參與開發

項目開源，歡迎任何開發者參與。請通過提交 issue 或 pull request 貢獻代碼。

📄 許可證

MIT