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