Stock Analysis MCP

🚀 Alpha Vantage 株式 MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を使用して構築されており、Alpha Vantage API から株式市場データを提供します。Claude やその他の MCP クライアントが、リアルタイムおよび過去の株式データにアクセスできるようにします。

✨ 主な機能

• カスタマイズ可能な間隔でのイントラデイ株式データの取得
• 毎日の株式データの取得
• 価格変動に基づく株式アラートの生成
• リソースとして直接株式データにアクセスする機能

📦 インストール

前提条件

• Node.js 16 以上
• Alpha Vantage API キー（無料で取得できます：Alpha Vantage）

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします：

   npm install
   

3. プロジェクトのルートディレクトリに .env ファイルを作成し、Alpha Vantage API キーを追加します：

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

ビルドと実行

TypeScript コードをビルドします：

npm run build

サーバーを起動します：

npm start

開発時に自動リロードを使用するには：

npm run dev

API クライアントをテストします：

npm test

Claude Desktop との統合

この MCP サーバーを Claude Desktop と一緒に使用するには：

1. Claude Desktop を開きます。
2. 設定 > 開発者 > 設定の編集に移動します。
3. claude_desktop_config.json に以下の内容を追加します：

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
      } 
    }
  }
}

/absolute/path/to/dist/index.js を、ビルドディレクトリの実際のパスに置き換えます。 4. Claude Desktop を再起動します。

💻 使用例

利用可能なツール

get-stock-data

特定の株式のイントラデイデータを取得します。 パラメーター：

• symbol（必須）：株式銘柄コード（例: IBM、AAPL）
• interval（オプション）：データポイント間の間隔時間（1min、5min、15min、30min、60min）。デフォルト値: 5min
• outputsize（オプション）：返されるデータ量（compact: 最新の 100 データポイント、full: 最大 20 年分のデータ）。デフォルト値: compact

get-daily-stock-data

特定の株式の毎日のデータを取得します。 パラメーター：

• symbol（必須）：株式銘柄コード（例: IBM、AAPL）
• outputsize（オプション）：返されるデータ量（compact: 最新の 100 データポイント、full: 最大 20 年分のデータ）。デフォルト値: compact

get-stock-alerts

株式データを分析して、価格変動に関するアラートを生成します。 パラメーター：

• symbol（必須）：株式銘柄コード（例: IBM、AAPL）
• threshold（オプション）：価格変動率の閾値。デフォルト値: 5

利用可能なリソース

stock-data

リソースとして直接株式データにアクセスします。 URI テンプレート：stock://{symbol}/{interval} パラメーター：

• symbol：株式銘柄コード（例: IBM、AAPL）
• interval：時間間隔（毎日、1min、5min、15min、30min、60min）。デフォルト値: 毎日 使用例：
• “Can you analyze this stock data: stock://AAPL/daily”
• “What do you think about this data: stock://MSFT/5min”

📄 ライセンス

ISC