Financial Datasets MCP Server

Financial Datasets MCP Server

はじめに

これは、Financial Datasets の株式市場データにアクセスできる Model Context Protocol（MCP）サーバーです。

Claude やその他の AI アシスタントが、MCP インターフェースを通じて損益計算書、貸借対照表、キャッシュフロー計算書、株価、市場ニュースを直接取得できます。

利用可能なツール

この MCP サーバーでは、以下のツールを利用できます。

• get_income_statements：企業の損益計算書を取得します。
• get_balance_sheets：企業の貸借対照表を取得します。
• get_cash_flow_statements：企業のキャッシュフロー計算書を取得します。
• get_current_stock_price：企業の現在または最新の株価を取得します。
• get_historical_stock_prices：企業の過去の株価を取得します。
• get_company_news：企業のニュースを取得します。
• get_available_crypto_tickers：利用可能なすべての暗号資産ティッカーを取得します。
• get_crypto_prices：暗号資産の過去の価格を取得します。
• get_historical_crypto_prices：暗号資産の過去の価格を取得します。
• get_current_crypto_price：暗号資産の現在または最新の価格を取得します。

セットアップ

前提条件

• Python 3.10 以降
• uv パッケージマネージャー

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/financial-datasets/mcp-server
   cd mcp-server
   

2. uv がインストールされていない場合は、インストールします：

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Windows
   curl -LsSf https://astral.sh/uv/install.ps1 | powershell
   

3. 依存関係をインストールします：

   # Create virtual env and activate it
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv add "mcp[cli]" httpx  # On Windows: uv add mcp[cli] httpx
   
   

4. 環境変数を設定します：

   # Create .env file for your API keys
   cp .env.example .env
   
   # Set API key in .env
   FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
   

5. サーバーを起動します：

   uv run server.py
   

Claude Desktop への接続

1. まだインストールしていない場合は、Claude Desktop をインストールします

2. Claude Desktop の設定ファイルを作成または編集します：

   # macOS
   mkdir -p ~/Library/Application\ Support/Claude/
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

3. 以下の設定を追加します：

   {
     "mcpServers": {
       "financial-datasets": {
         "command": "/path/to/uv",
         "args": [
           "--directory",
           "/absolute/path/to/financial-datasets-mcp",
           "run",
           "server.py"
         ]
       }
     }
   }
   

   /path/to/uv を which uv の実行結果に、/absolute/path/to/financial-datasets-mcp をこのプロジェクトの絶対パスに置き換えます。

4. Claude Desktop を再起動します

5. Claude Desktop のツールメニュー（ハンマーアイコン）に金融ツールが表示されます

6. 次のような質問を Claude にしてみましょう：

   • 「Apple の最近の損益計算書を教えてください」
   • 「Tesla 株の現在の価格を表示してください」
   • 「2024-01-01 から 2024-12-31 までの MSFT の過去の価格を取得してください」