Financial Reports MCP Server

財務レポート MCP サーバー

🎬 デモ

財務レポート API にアクセスするための MCP（Model Context Protocol）サーバーです。企業の財務報告書、業界分類、関連データにアクセスするためのツールとリソースを提供します。

機能

• 企業名、国、セクターで企業を検索
• 企業の詳細情報を取得
• 最新の財務報告書にアクセス
• 業界分類を参照
• 報告書の詳細と内容を取得

前提条件

• Python 3.11+
• Docker（推奨）
• FastMCP（ローカルで実行する場合）
• dotenv（ローカルで実行する場合の環境変数管理用）

注記： 簡潔さと信頼性を高めるため、サーバーは実際の財務レポート API のみを使用するようになりました。モック API のロジックと設定はすべて削除されています。

🚀 はじめに

この MCP サーバーを実行する方法はいくつかあります。以下から選択してください。

オプション 1：Docker（推奨）

再現性、分離、使いやすさの観点から、MCP サーバーの実行には Docker を推奨します。

# Build (once)
docker build -t financial-reports-mcp .

# Run
docker run --rm -i \
  -e API_KEY=your_api_key_here \
  -e API_BASE_URL=https://api.financialreports.eu/ \
  -e MCP_TRANSPORT=stdio \
  financial-reports-mcp:latest

Docker Compose を使用する場合：

# Copy and configure .env
echo "Copy .env.example to .env and fill in secrets"
cp .env.example .env
# Start services
docker-compose up

Claude Desktop では、以下の設定を使用してください。互換性とセキュリティを最大限に高めるため、シークレットは args の -e 引数として渡してください。

{
  "mcpServers": {
    "financial-reports": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "API_KEY=your_api_key_here",
        "-e", "API_BASE_URL=https://api.financialreports.eu/",
        "-e", "MCP_TRANSPORT=stdio",
        "financial-reports-mcp:latest"
      ]
    }
  }
}

理由： シークレットを args の -e 引数として渡すことで、クライアントによる環境変数のサポート方法にかかわらず、Docker が常にシークレットを受け取るようになります。これは Claude Desktop や同様のクライアントで使える、最も堅牢で移植性の高い方法です。

オプション 2：Smithery CLI（Claude 用）

Smithery CLI を使用して、Claude でサーバーをインストールして実行します。

npx -y @smithery/cli@latest install \
  @itisaevalex/financial-reports-mcp-server \
  --client claude \
  --key smithery_api_key

オプション 3：ローカルの Python（開発／テスト用）

1. 依存関係をインストールします。

python -m venv venv           # Create venv
venv\Scripts\activate        # Activate on Windows
pip install -r requirements.txt

2. サーバーを実行します。

python -m src.financial_reports_mcp
# or with uv
uv run src/financial_reports_mcp.py

ヒント： uv を使用すると、プロジェクトのルートにある .env が自動的に読み込まれます。

使用例

すべてのサンプルスクリプトと設定ファイルは、examples/ ディレクトリにあります。例：

• examples/test_server.py — MCP のテストスイート全体を実行
• examples/docker_claude_config.json — Docker 用 Claude Desktop 設定の例
• examples/uvx_claude_config.json — uv 用 Claude Desktop 設定の例
• examples/python_client_example.py — Python クライアントの使用例

テストスイートを実行します。

python examples/test_server.py

設定

ルートディレクトリに .env ファイルを作成し、以下の変数を設定します。

API_KEY=your_api_key_here
API_BASE_URL=https://api.financialreports.eu/
MCP_TRANSPORT=stdio

プロジェクト構成

• src/ — ソースコードディレクトリ
  • financial_reports_mcp.py — MCP サーバーのメインエントリーポイント（すべてのツール／リソースをここで定義）
  • api_client.py — API クライアントファクトリー
  • real_api/real_client.py — 実際の API クライアントの実装
• .env - 環境変数（Git 管理対象外）
• requirements.txt - プロジェクトの依存関係
• Dockerfile & docker-compose.yml - Docker の設定
• setup.py - パッケージのインストール設定
• install.py - Claude Desktop のインストール用ヘルパー
• examples/ - サンプルスクリプトと設定ファイル
• scripts/ - インストールスクリプト

利用可能なツール

• get_filing_type(filing_type_id) — ID で提出書類の種類の詳細情報を取得します
• list_industries(industry_group, page, page_size, search) — 利用可能な GICS 産業をすべて一覧表示します
• get_industry(industry_id) — GICS 産業の詳細情報を取得します
• list_industry_groups(sector, page, page_size, search) — 利用可能な GICS 産業グループをすべて一覧表示します
• get_industry_group(group_id) — GICS 産業グループの詳細情報を取得します
• get_sector(sector_id) — GICS セクターの詳細情報を取得します
• list_sub_industries(industry, page, page_size, search) — 利用可能な GICS サブ産業をすべて一覧表示します
• get_sub_industry(sub_industry_id) — GICS サブ産業の詳細情報を取得します
• list_sources(page, page_size) — 利用可能なデータソースをすべて一覧表示します
• get_source(source_id) — データソースの詳細情報を取得します
• get_processed_filing(processed_filing_id) — 提出書類の処理済みコンテンツを取得します
• get_schema(format, lang) — API の OpenAPI3 スキーマを取得します
• search_companies(params) — 会社名、ISIN、LEI などで企業を検索します
• get_company_detail(company_id) — 企業の詳細情報を取得します
• get_latest_filings(params) — 最新の財務提出書類を取得します
• get_filing_detail(filing_id) — 特定の提出書類の詳細情報を取得します
• list_sectors() — 利用可能な GICS セクターをすべて一覧表示します
• list_filing_types() — 利用可能な提出書類の種類をすべて一覧表示します

追加のリソース／ヘルパー

• get_sectors_resource() — GICS セクターの Markdown 形式の一覧
• get_filing_types_resource() — 提出書類の種類の Markdown 形式の一覧
• get_company_profile(company) — 企業プロフィールを Markdown 形式で取得します
• get_company_recent_filings(company, limit) — 最近の提出書類の Markdown 形式の一覧

プロンプト

• search_company_by_name() — 会社名で企業を検索するプロンプト
• find_latest_annual_reports() — 最新の年次報告書を見つけるプロンプト

利用可能なリソース

• financial-reports://sectors：すべての GICS セクターの一覧
• financial-reports://filing-types：すべての提出書類の種類の一覧
• financial-reports://companies/{company_id}/profile：企業プロフィール
• financial-reports://companies/{company_id}/recent-filings：企業の最近の提出書類

使用例

例 1：企業を検索してプロフィールを取得する

I want to search for information about Deutsche Bank. Please help me find:
1. Basic company details like country, sector and industry
2. Recent financial filings
3. Key financial metrics if available

例 2：銀行の最新の年次報告書を見つける

I'd like to see the latest annual reports from major European banks. 
Please help me:
1. Find companies in the banking sector
2. Get their latest annual reports
3. Summarize key financial metrics from these reports if available

クロスプラットフォーム互換性

サーバーは以下の環境で実行できます。

• Linux：すべてのメソッドに対応
• macOS：すべてのメソッドに対応
• Windows：すべてのメソッドに対応。ただし、Claude Desktop では uv の使用を推奨します

Windows ユーザー向けの注意事項：

• Claude Desktop では、uv を使用したインストールを推奨します
• Docker には Windows 用 Docker Desktop が必要です

トラブルシューティング

よくある問題

1. Claude Desktop との通信の問題：

   • Claude Desktop の設定時に stdio トランスポートを使用していることを確認してください
   • Docker の場合は、対話モード用の -i フラグを含めてください

2. 「Module not found」エラー：

   • pip install -r requirements.txt ですべての依存関係がインストールされていることを確認してください

3. MCP サーバーに接続できない：

   • サーバーが実行中で、クライアントからアクセスできることを確認してください

4. API の認証エラー：

   • .env ファイルの API キーを確認してください

ログ

直接実行する場合、ログはコンソールに出力されます。Docker の場合は、次のコマンドでログを確認できます。

docker logs <container-id>

ライセンス

このプロジェクトは、Data Alchemy Labs への帰属表示を条件として、MIT ライセンスの下でライセンスされています。詳細は LICENSE を参照してください。