Ibex35 MCP Server

🚀 IBEX 35 MCP Server

このサーバーは、Model Context Protocol (MCP) を利用して、Claudeやその他の大規模言語モデル（LLM）に、スペインのIBEX 35株式市場データ、企業統治情報、および財務分析情報を提供します。

🚀 クイックスタート

前提条件

• Node.js 18以上
• Claude Desktopアプリ（またはMCP互換のクライアント）

インストール

オプション1: NPMを使用したグローバルインストール（推奨）

npm install -g ibex35-mcp-server

オプション2: ソースからのインストール

git clone https://github.com/anbrme/ibex35-mcp-server.git
cd ibex35-mcp-server
npm install
npm run build

設定

環境変数

• IBEX35_API_URL: Cloudflare Worker APIのURL（デフォルトは https://ibex35-api.ncdata.eu）
• IBEX35_API_KEY: 認証用のオプションAPIキー（Workerが必要とする場合）

Cloudflare Workerの設定

サーバーは、D1データベースへのAPIアクセスを提供する既存のCloudflare Workerに接続します。ローカルデータベースの設定は不要です。

使用方法

スタンドアロンモード

npm start

Claude Desktopの設定

claude_desktop_config.json に以下を追加します。

NPMインストールの場合:

{
  "mcpServers": {
    "ibex35-database": {
      "command": "ibex35-mcp",
      "env": {
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

ソースからインストールした場合:

{
  "mcpServers": {
    "ibex35-database": {
      "command": "node",
      "args": ["/path/to/ibex35-mcp-server/dist/index.js"],
      "env": {
        "IBEX35_API_URL": "https://ibex35-api.ncdata.eu"
      }
    }
  }
}

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

使用開始

1. Claude Desktopを完全に再起動します。
2. 新しい会話を開始します。
3. IBEX 35のデータに関する質問をします！

✨ 主な機能

コアデータアクセス

• 企業情報: すべてのIBEX 35企業のリアルタイム価格と主要指標
• 過去のデータ: OHLCVデータ、パフォーマンス追跡、トレンド分析
• 株主: 所有構造、集中度分析、相互持株
• 取締役: 企業統治、取締役の兼務、幹部関係
• ニュースとセンチメント: センチメント分析と関連性スコア付きの最新ニュース
• ESGデータ: 環境、社会、ガバナンスのスコアと指標

高度な分析 ⚡ 強化版

• 自然言語処理: 平易な英語で複雑な質問をすることができます。
• 企業比較: 財務、ガバナンス、パフォーマンス指標を横断的に分析します。
• トレンド分析と予測: 高度な価格トレンド分析と簡単な予測機能があります。
• 投資リスク評価: 市場、ガバナンス、運用要因にわたる包括的なリスク評価を行います。
• アナリストレポート生成: 専門的な企業の深掘りレポート、セクターの概要、ガバナンス分析を生成します。
• 投資機会スクリーニング: カスタム基準に基づいて企業をフィルタリングし、ランク付けします。
• ネットワーク分析: 取締役の兼務分析、株主の重複検出を行います。
• ガバナンスリスク評価: 警告シグナルの特定、集中度指標を評価します。
• 市場相関分析: セクターのパフォーマンス分析と相関研究を行います。
• ロビー活動情報: EUの透明性データと政治的影響力の追跡を行います。

特別な機能

• リアルタイム同期: Google Sheetsや複数のソースからデータを同期します。
• 週次レポート: 自動化された市場分析とガバナンスのハイライトを提供します。
• カスタムクエリ: データベースに対して安全なSQLクエリを実行できます。
• 包括的なインデックス: 複雑な関係クエリに最適化されています。

💻 使用例

基本的な使用法

# すべてのIBEX 35企業のリストを取得
get_all_companies

高度な使用法

# 特定のP/Eレンジで企業をフィルタリング
get_companies_with_pe_ratio --min 10 --max 20

📚 ドキュメント

利用可能なツール

企業データ

• get_all_companies - 現在のデータを含むすべてのIBEX 35企業のリストを取得
• get_company_by_symbol - シンボルによる詳細な企業情報を取得
• get_companies_by_sector - セクターで企業をフィルタリング
• get_companies_with_pe_ratio - P/Eレンジでフィルタリング

ガバナンスとリーダーシップ

• get_company_directors - 企業の取締役を取得
• get_board_interlocks - 複数の取締役会に所属する取締役を取得
• get_directors_by_name - すべての企業の取締役を名前で検索

所有権分析

• get_company_shareholders - 企業の株主構造を取得
• get_shareholder_overlap - 複数の企業に株式を保有する株主を取得
• get_top_shareholders_by_sector - セクター別の上位株主を取得

市場データ

• get_historical_prices - 過去のOHLCVデータを取得
• get_top_performers - 期間中の最高/最低パフォーマンスの企業を取得

ニュースとセンチメント

• get_recent_news - センチメント付きの最新ニュース記事を取得
• get_news_by_sentiment - センチメント（ポジティブ/ネガティブ/中立）でニュースをフィルタリング

ロビー活動と透明性

• get_lobbying_meetings - EUのロビー活動の会議と活動を取得
• get_most_active_lobbyists - 最も活発なロビイスト組織を取得

高度な分析

• get_network_analysis - ガバナンス関係の完全なネットワーク分析を取得
• get_sector_correlation_analysis - セクターのパフォーマンス相関分析を取得

⚡ 強化版 AIによる分析

• analyze_natural_query - 複雑な自然言語クエリをインテリジェントにルーティングして処理
• compare_companies - 多面的な企業比較（財務、ガバナンス、パフォーマンス）
• analyze_trends - 予測機能付きの高度なトレンド分析（企業、セクター、市場、相関）
• assess_investment_risk - 包括的な投資リスク評価（市場、ガバナンス、セクター、流動性、集中度）
• generate_analyst_report - 専門的なアナリストレポート（企業の深掘り、セクターの概要、ガバナンス分析）
• screen_opportunities - カスタム基準とスコアリングによる投資機会スクリーニング
• get_weekly_reports - 生成された週次の市場とガバナンスレポートを取得
• get_esg_scores - ESGスコアと持続可能性指標を取得
• execute_custom_query - カスタムSQLクエリ（SELECTのみ）を実行

サンプルクエリ

接続後、ClaudeにIBEX 35のデータに関する自然言語の質問をすることができます。

企業統治

"複数のIBEX 35の取締役会に所属するすべての取締役を表示してください"
"政治的背景または政府との関係を持つ取締役は誰ですか？"
"IBEX 35の企業統治における潜在的な利益相反を見つけてください"
"スペインの企業ネットワークで最も多くの関係を持つ取締役は誰ですか？"

財務分析

"時価総額が最も大きいIBEX 35の企業はどれですか？"
"P/Eレンジが15未満の企業を表示してください"
"IBEX 35に含まれるエネルギーセクターの企業はどれですか？"
"銀行株と通信株のパフォーマンスを比較してください"

株主情報

"複数のIBEX 35企業に株式を保有する機関投資家を見つけてください"
"バンコ・サンタンダーの所有構造を表示してください"
"所有権が最も集中している企業はどれですか？"
"エネルギーセクターにおける株主の重複を特定してください"

市場パフォーマンス

"今月最もパフォーマンスが良いIBEX 35の株はどれですか？"
"最近10%以上下落した企業を表示してください"
"IBEX 35全体のセクターパフォーマンスを比較してください"
"P/Eレンジに基づいて割安な企業を見つけてください"

研究と分析

"IBEX 35の取締役会内の政治的関係を分析してください"
"再生可能エネルギー企業の最近のニュースセンチメントを表示してください"
"最も多様な取締役会を持つ企業はどれですか？"
"疑わしいガバナンスパターンを持つ企業を見つけてください"

⚡ 強化版 自然言語分析

"先月最も成長した銀行株はどれですか？"
"ガバナンスリスクが高い企業を表示し、理由を説明してください"
"サンタンダーとBBVAをすべての指標で比較してください"
"ガバナンススコアの良い割安な大型株企業を見つけてください"
"エネルギーセクターの見通しに関する包括的なレポートを生成してください"
"通信株の価格トレンドはどうですか？"
"銀行セクターの投資リスクを評価してください"
"P/Eが15未満、時価総額が100億以上、エネルギーセクターを除外した投資機会をスクリーニングしてください"

🔧 技術詳細

セキュリティ

• 読み取り専用アクセス: データベース接続は読み取り専用です。
• クエリ制限: カスタムクエリではSELECT文のみが許可されます。
• 入力検証: すべてのパラメーターは検証され、サニタイズされます。
• 危険な操作の禁止: DROP、DELETE、UPDATEなどの操作はブロックされます。

データベーススキーマ

サーバーは以下を含む包括的なスキーマで動作します。

• companies: 企業のコアデータと指標
• company_directors: 取締役会と幹部の情報
• company_shareholders: 所有構造
• historical_prices: 日次のOHLCV市場データ
• company_news: センチメント分析付きのニュース記事
• lobbying_meetings: EUの透明性とロビー活動データ
• company_esg: ESGスコアと持続可能性指標
• weekly_reports: 生成された分析レポート

開発

# 自動リロード付きの開発モード
npm run dev

# TypeScriptのビルド
npm run build

# 本番サーバーの起動
npm start

貢献

このMCPサーバーは、IBEX 35ダッシュボードエコシステムと連携するように設計されています。既存のデータベーススキーマと同期プロセスとの互換性を維持するように変更を行ってください。

📊 データソース

このMCPサーバーは、スペインの信頼できるソースからデータを集約します。

• マドリード証券取引所 (BME) - リアルタイムの市場データと取引情報
• CNMV - 公式の規制ファイリングと株主開示
• EU Transparency Register - 企業のロビー活動と会議
• 企業のWebサイト - 取締役会の構成とガバナンス構造
• 金融ニュースソース - 市場センチメントと企業固有のニュース

🔒 プライバシーとセキュリティ

• APIキー不要: 公開されているデータソースを使用しています。
• 個人データなし: 公開されている企業情報のみを扱います。
• トラッキングなし: データ収集なしで直接APIにアクセスします。
• オープンソース: データ処理と分析の完全な透明性を提供します。
• 読み取り専用アクセス: データを変更または削除することはできません。

📈 ユースケース

金融関係者

• デューディリジェンスと投資研究
• ガバナンス分析によるリスク評価
• 市場トレンドの特定とセクター分析
• 競争力分析とベンチマーク

学術研究者

• 企業統治の研究と分析
• スペインの政治経済学の研究
• 企業関係のネットワーク分析
• 金融市場の行動研究

コンプライアンスとリスク管理

• 取締役会の独立性の検証
• 政治的関係の特定
• 所有権の集中度分析
• ガバナンスの警告シグナルの検出

ジャーナリストとアナリスト

• 企業関係の調査研究
• 政治的影響力のマッピング
• 市場分析とレポーティング
• 企業の透明性評価

🛠 トラブルシューティング

Claudeがサーバーを認識しない場合

1. 設定ファイルの場所とJSON構文を確認してください。
2. Claude Desktopを完全に再起動してください（⌘+Qで閉じてから再開）。
3. Node.jsのバージョン（18以上）とインストールを確認してください。

インストール時の問題

# Node.jsのバージョンを確認
node --version

# 必要に応じてnpmキャッシュをクリア
npm cache clean --force

# 再インストール
npm install -g ibex35-mcp-server

API接続の問題

サーバーは公開APIを使用しているため、認証は必要ありません。エラーが表示される場合は、以下を試してください。

# APIのアクセシビリティをテスト
curl https://ibex35-api.ncdata.eu/api/companies

🤝 貢献

貢献を歓迎します！改善のための領域は以下の通りです。

• 追加のデータソースと指標
• パフォーマンスの最適化
• 新しい分析機能
• ドキュメントの改善

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されており、商用および非商用の使用が無料で許可されています。

🔗 関連リソース

• IBEX 35 Dashboard - インタラクティブなWebインターフェイス
• Model Context Protocol - 公式のMCPドキュメント
• Claude Desktop - Claude Desktopアプリのダウンロード
• PulseMCP - 他のMCPサーバーを探す

🌟 サポートとコミュニティ

• GitHub Issues: バグの報告や機能のリクエスト
• GitHub Discussions: コミュニティのサポートとアイデアの共有
• Webダッシュボード: Webインターフェイスを通じてデータを試すことができます。
• モデル推奨: Claude 4 Sonnetとの組み合わせが最適です。

❤️ ClaudeとMCPコミュニティのために作成されました

世界中のAIアシスタントにスペインの企業情報を提供します