MCP Stocks Info Server

🚀 MOEX Stocks and News MCP Server

The MCP (Model Context Protocol) server is used to access the stock market data and financial news of the Moscow Exchange (MOEX). It provides interfaces for interacting with Large Language Models (LLMs) to obtain real-time market information and news.

🚀 Quick Start

The MCP server enables access to MOEX's stock market data and financial news, and offers interfaces for interaction with LLMs to acquire real - time information.

✨ Features

• Retrieve market information of stocks listed on MOEX.
• View the top gainers.
• View the top losers.
• Search for stocks by name or code.
• Get today's financial news.
• Search for news related to keywords.
• Get news related to a specific stock ticker.

📦 Installation

Requirements

• Basic dependency: Go language development environment.
• Third - party services: MongoDB, Redis, MOEX API, NewsAPI.
• The configuration file needs to provide access credentials for each interface.

Steps

1. Clone the code repository:

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

2. Set up the local database environment:

• MongoDB: Run mongod --dbpath=/data/db.
• Redis: Start the service and listen on port 6379.

3. Configure the project: Edit the configuration file and fill in the connection information and API keys for each module.
4. Start the service:

go run main.go

🔧 Technical Details

Database Configuration Example:

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

Cache Configuration Example:

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

💻 Usage Examples

Integrating with LLM

The project provides various tools and prompt templates for easy interaction with LLMs.

Available Tools:

• get_stock_info: Retrieve stock market information.
• get_top_gainers: View the top gainers.
• get_top_losers: View the top losers.
• search_stocks: Search for stocks by name or code.
• get_today_news: Get today's news.
• search_news: Search for news by keywords.
• get_news_by_ticker: Get news related to a specific stock ticker.

Available Prompt Templates:

• stock_analysis: Analyze the market of an individual stock.
• market_overview: Provide an overall market overview.
• news_analysis: Interpret today's important news.

🤝 How to Contribute

This project is open - source. Any developers are welcome to participate. Please contribute code by submitting issues or pull requests.

📄 License

MIT