Financial Reports MCP Server

🚀 金融レポートMCPサーバー

このサーバーは金融データレポートを処理するためのMCP（多プロトコル通信）サーバーで、様々なインターフェースと機能をサポートしています。

✨ 主な機能

• 業種分類：GICS（グローバル産業分類標準）業種の照会と管理をサポートします。
• ファイルタイプ：各種財務諸表タイプの詳細情報を提供します。
• 企業情報：企業に対する多面的な検索と詳細照会をサポートします。
• filings取得：企業の最新の財務報告を取得できます。
• データソース：複数のデータソースの照会と管理をサポートします。

📦 インストール

前提条件

システム要件

• オペレーティングシステム：Linux、macOS、Windows（Dockerの使用を推奨）
• Pythonバージョン：3.8以上

依存関係のインストール

pip install -r requirements.txt

起動方法

いくつかの起動方法があります。

方法一：直接実行

python mcp_server.py

方法二：uvを使用（Windowsでの使用を推奨）

1. uvをインストール：

   npm install -g uv
   

2. サービスを起動：

   uv mcp_server.uv
   

方法三：Dockerで実行

docker build -t financial-reports-mcp .
docker run --rm -it financial-reports-mcp

📚 ドキュメント

設定説明

以下の内容を設定ファイル（.env）に記入してください。

API_KEY=your_api_key
DB_HOST=localhost
DB_PORT=5432

プロジェクト構造

financial-reports-mcp/
├── mcp_server.py          # メインプログラムのエントリーポイント
├── resources/            # リソースファイル
│   ├── sectors.md        # 業種分類リスト
│   └── filing_types.md   # ファイルタイプリスト
├── schemas/              # OpenAPI3 Schema定義
│   └── api.json          # APIインターフェース定義
└── requirements.txt      # 依存関係管理ファイル

利用可能なリソース

コアインターフェース

• get_filing_type(filing_type_id)：ファイルタイプIDを使用して詳細情報を取得します。
• list_industries(...)：すべてのGICS業種をリストします。
• get_company_detail(company_id)：企業IDを使用して詳細情報を取得します。

サンプルリソース

• financial-reports://sectors：すべてのGICS業種のリスト
• financial-reports://filing-types：すべてのファイルタイプのリスト

利用例

例1：企業情報の照会

私はドイツ銀行の基本情報、所在国、業種、最新の財務報告を調べたいです。

例2：業種情報の取得

すべてのテクノロジー関連のGICS業種をリストし、各業種の詳細な説明を提供してください。

マルチプラットフォーム互換性

• Linux：すべての起動方法をサポートします。
• macOS：すべての起動方法をサポートします。
• Windows：
  • Claude Desktopのデプロイにはuvの使用をおすすめします。
  • Dockerを使用する場合は、Docker Desktop for Windowsをインストールする必要があります。

トラブルシューティング

一般的な問題

1. 通信問題：
   • stdio伝送モードを使用していることを確認してください。
   • Dockerを起動する際に-iパラメータを追加してください。
2. モジュールが見つからない：
   • すべての依存関係をインストールしてください：pip install -r requirements.txt
3. サーバーに接続できない：
   • サーバーが正常に起動し、対応するポートを監視していることを確認してください。
4. API認証に失敗した：
   • .envファイルのAPI_KEY設定が正しいことを確認してください。

ログの確認

• 直接実行する場合：ログはコンソールに出力されます。
• Dockerで実行する場合：docker logs <container-id>を使用してログを確認してください。

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。

お問い合わせ

ご質問やフィードバックがある場合は、以下の方法でお問い合わせください。

• メール：support@financial-reports.com
• 電話：+86-123-4567890