Stock Market MCP Server

株式市場 MCP サーバー

株式市場データを取得するための TypeScript ベースの MCP サーバーです。Alpha Vantage API を通じて、リアルタイムの株式市場情報と企業の財務データを提供します。

この MCP サーバーの生成に関する重要な情報

• .clinerules
• API キー

1.Plan mode

help me build a stock market mcp server that uses the AlphaVantage public API
I want it to have these tools：
- generate US market report/briefing
- generate financial statement for company
- get ticker price for company
- any other basic tools you think would be helpful
- api key: <you api key>


2. please test all the tools to confirm their functionality

主な機能

ツール

• get_ticker_price - 株式のリアルタイム価格を取得します

  • パラメーターとして株式コードを指定する必要があります
  • 最新の株価とタイムスタンプを返します

• get_market_report - 米国市場のレポートを取得します

  • 市場全体の状況の概要を提供します

• get_financial_statement - 企業の財務諸表を取得します

  • 3 種類の報告書に対応しています：損益計算書(income)、貸借対照表(balance)、キャッシュフロー計算書(cashflow)
  • 株式コードと報告書の種類を指定する必要があります

• get_company_overview - 企業の概要情報を取得します

  • 株式コードを指定する必要があります
  • 企業の主要指標と基本情報を返します

開発環境のセットアップ

依存関係のインストール

npm install

プロジェクトのビルド

npm run build

開発モード（自動再ビルド）

npm run watch

インストール方法

このサーバーを Claude Desktop で使用するには、サーバー設定を追加する必要があります。

MacOS

設定ファイルのパス：~/Library/Application Support/Claude/claude_desktop_config.json

Windows

設定ファイルのパス：%APPDATA%/Claude/claude_desktop_config.json

設定例：

{
  "mcpServers": {
    "stock-market-server": {
      "command": "/path/to/stock-market-server/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは標準入出力(stdio)を介して通信するため、デバッグが難しい場合があります。デバッグには MCP Inspector ツールの使用をおすすめします。

npm run inspector

実行すると、Inspector がブラウザーでアクセスできるアドレスを表示します。ブラウザーからデバッグツールを使用できます。

技術スタック

• TypeScript
• Node.js
• Alpha Vantage API
• MCP SDK (@modelcontextprotocol/sdk)

注意事項

• 使用前に、有効な Alpha Vantage API キーがあることを確認してください
• すべての API レスポンスは JSON 形式で返されます
• Alpha Vantage API の呼び出し頻度制限にご注意ください

ライセンス

[ライセンス情報を追加]