Bloomberg MCP Server

FastMCPを使ったBloomberg API市場データ取得サーバーです。

🚀 サーバー起動方式

方式1: stdio (推奨) - プロセス間通信

# デフォルト - Claude Desktop等での標準的な使用方法
python server.py

# または明示的にstdio指定
python server_http.py --stdio

ホスト・ポート不要
Claude Desktop設定例 (claude_desktop_config.json):

{
  "mcpServers": {
    "bloomberg-server": {
      "command": "python",
      "args": ["/path/to/your/server.py"],
      "env": {
        "PYTHONPATH": "/path/to/your/project"
      }
    }
  }
}

方式2: HTTP/SSE - ネットワーク経由

# HTTPサーバーとして起動 (デフォルト: localhost:8080)
python server_http.py

# カスタムホスト・ポート指定
python server_http.py --host 0.0.0.0 --port 3000

アクセスURL: http://localhost:8080/sse
他のマシンからもアクセス可能
Web UIやカスタムクライアントでの使用に適している

📊 機能

市場データ取得ツール

search_securities - 証券検索（会社名、ティッカー等から候補を検索）
search_fields - フィールド検索（利用可能なBloombergフィールドを検索）
get_reference_data - 現在の市場データ取得（BDP機能相当）
get_historical_data - 過去データ取得（BDH機能相当）
get_bulk_data - バルクデータ取得（BDS機能相当）

使用例

# 証券検索
search_securities("Apple", max_results=10)

# フィールド検索  
search_fields("price", max_results=20)

# 現在の株価取得
get_reference_data("AAPL US Equity", ["PX_LAST", "VOLUME"])

# 過去データ取得
get_historical_data(
    "AAPL US Equity", 
    ["PX_LAST", "PX_VOLUME"], 
    "2024-01-01", 
    "2024-12-31"
)

# インデックス構成銘柄取得
get_bulk_data("SPX Index", "INDX_MEMBERS")

🔧 セットアップ

前提条件

Bloomberg Terminal契約およびログイン
Bloomberg Desktop APIアクセス権限
Python 3.8以上

1. 依存関係のインストール

# pip使用の場合
pip install -r requirements.txt

# uv使用の場合（推奨）
uv sync

2. Bloomberg Terminalの起動

Bloomberg Terminalにログインし、APIが利用可能な状態にしてください。

3. サーバー起動

# stdio方式（Claude Desktop用）
python server.py

# HTTP方式（Web UI等用）
python server_http.py --host 0.0.0.0 --port 8080

🌐 ネットワーク接続詳細

stdio方式の仕組み

[Claude Desktop] ←→ [MCPサーバープロセス]
      ↑                    ↓
   JSON-RPC          Bloomberg API
   (stdin/stdout)    (localhost:8194)

HTTP/SSE方式の仕組み

[Webクライアント] ←→ [HTTPサーバー:8080] ←→ [Bloomberg API]
      ↑                     ↓                    ↓
   HTTP/SSE             FastMCP              localhost:8194

📡 Bloomberg API接続

サーバーは以下のサービスを使用します：

Bloomberg Terminal: localhost:8194 (Desktop API)
//blp/refdata - 参照データサービス（価格、ボリューム等）
//blp/apiflds - フィールド検索サービス

🔍 よく使用されるフィールド

PX_LAST - 最終価格
PX_VOLUME - 出来高
SECURITY_NAME - 証券名
GICS_SECTOR_NAME - GICS セクター
MARKET_CAP - 時価総額
DVD_HIST_ALL - 配当履歴
INDX_MEMBERS - インデックス構成銘柄

📈 証券コード形式

株式: AAPL US Equity
インデックス: SPX Index
債券: T 4.75 05/15/25 Govt
通貨: USDJPY Curncy
コモディティ: CL1 Comdty

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

接続エラー

# Bloomberg Terminal起動確認
# Windows: Ctrl+Alt+T でターミナル起動
# Bloomberg API状態確認: API <GO>

ポート競合（HTTP方式）

# 別ポートで起動
python server_http.py --port 3001

# プロセス確認
netstat -an | grep :8080

デバッグモード

# 詳細ログ出力
python server.py --debug

# 接続テスト
python examples.py

🎯 使用方法

Claude Desktop統合

claude_desktop_config.jsonにサーバー設定追加
Claude Desktop再起動
チャットで市場データ分析を依頼

カスタムクライアント開発

import requests

# HTTP API呼び出し例
response = requests.post(
    "http://localhost:8080/mcp",
    json={
        "method": "tools/call",
        "params": {
            "name": "get_reference_data",
            "arguments": {
                "securities": "AAPL US Equity",
                "fields": "PX_LAST"
            }
        }
    }
)

📄 ライセンス

このプロジェクトは個人使用を想定しています。Bloomberg APIの利用規約に従ってご使用ください。

🔗 関連ファイル

server.py - stdio版メインサーバー
server_http.py - HTTP/SSE版サーバー
utils.py - ユーティリティ関数
examples.py - 使用例デモ

Bloomberg MCP Server

FastMCPを使ったBloomberg API市場データ取得サーバーです。

🚀 サーバー起動方式

方式1: stdio (推奨) - プロセス間通信

# デフォルト - Claude Desktop等での標準的な使用方法
python server.py

# または明示的にstdio指定
python server_http.py --stdio

ホスト・ポート不要
Claude Desktop設定例 (claude_desktop_config.json):

{
  "mcpServers": {
    "bloomberg-server": {
      "command": "python",
      "args": ["/path/to/your/server.py"],
      "env": {
        "PYTHONPATH": "/path/to/your/project"
      }
    }
  }
}

方式2: HTTP/SSE - ネットワーク経由

# HTTPサーバーとして起動 (デフォルト: localhost:8080)
python server_http.py

# カスタムホスト・ポート指定
python server_http.py --host 0.0.0.0 --port 3000

アクセスURL: http://localhost:8080/sse
他のマシンからもアクセス可能
Web UIやカスタムクライアントでの使用に適している

📊 機能

市場データ取得ツール

search_securities - 証券検索（会社名、ティッカー等から候補を検索）
search_fields - フィールド検索（利用可能なBloombergフィールドを検索）
get_reference_data - 現在の市場データ取得（BDP機能相当）
get_historical_data - 過去データ取得（BDH機能相当）
get_bulk_data - バルクデータ取得（BDS機能相当）

使用例

# 証券検索
search_securities("Apple", max_results=10)

# フィールド検索  
search_fields("price", max_results=20)

# 現在の株価取得
get_reference_data("AAPL US Equity", ["PX_LAST", "VOLUME"])

# 過去データ取得
get_historical_data(
    "AAPL US Equity", 
    ["PX_LAST", "PX_VOLUME"], 
    "2024-01-01", 
    "2024-12-31"
)

# インデックス構成銘柄取得
get_bulk_data("SPX Index", "INDX_MEMBERS")

🔧 セットアップ

前提条件

Bloomberg Terminal契約およびログイン
Bloomberg Desktop APIアクセス権限
Python 3.8以上

1. 依存関係のインストール

# pip使用の場合
pip install -r requirements.txt

# uv使用の場合（推奨）
uv sync

2. Bloomberg Terminalの起動

Bloomberg Terminalにログインし、APIが利用可能な状態にしてください。

3. サーバー起動

# stdio方式（Claude Desktop用）
python server.py

# HTTP方式（Web UI等用）
python server_http.py --host 0.0.0.0 --port 8080

🌐 ネットワーク接続詳細

stdio方式の仕組み

[Claude Desktop] ←→ [MCPサーバープロセス]
      ↑                    ↓
   JSON-RPC          Bloomberg API
   (stdin/stdout)    (localhost:8194)

HTTP/SSE方式の仕組み

[Webクライアント] ←→ [HTTPサーバー:8080] ←→ [Bloomberg API]
      ↑                     ↓                    ↓
   HTTP/SSE             FastMCP              localhost:8194

📡 Bloomberg API接続

サーバーは以下のサービスを使用します：

Bloomberg Terminal: localhost:8194 (Desktop API)
//blp/refdata - 参照データサービス（価格、ボリューム等）
//blp/apiflds - フィールド検索サービス

🔍 よく使用されるフィールド

PX_LAST - 最終価格
PX_VOLUME - 出来高
SECURITY_NAME - 証券名
GICS_SECTOR_NAME - GICS セクター
MARKET_CAP - 時価総額
DVD_HIST_ALL - 配当履歴
INDX_MEMBERS - インデックス構成銘柄

📈 証券コード形式

株式: AAPL US Equity
インデックス: SPX Index
債券: T 4.75 05/15/25 Govt
通貨: USDJPY Curncy
コモディティ: CL1 Comdty

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

接続エラー

# Bloomberg Terminal起動確認
# Windows: Ctrl+Alt+T でターミナル起動
# Bloomberg API状態確認: API <GO>

ポート競合（HTTP方式）

# 別ポートで起動
python server_http.py --port 3001

# プロセス確認
netstat -an | grep :8080

デバッグモード

# 詳細ログ出力
python server.py --debug

# 接続テスト
python examples.py

🎯 使用方法

Claude Desktop統合

claude_desktop_config.jsonにサーバー設定追加
Claude Desktop再起動
チャットで市場データ分析を依頼

カスタムクライアント開発

import requests

# HTTP API呼び出し例
response = requests.post(
    "http://localhost:8080/mcp",
    json={
        "method": "tools/call",
        "params": {
            "name": "get_reference_data",
            "arguments": {
                "securities": "AAPL US Equity",
                "fields": "PX_LAST"
            }
        }
    }
)

📄 ライセンス

このプロジェクトは個人使用を想定しています。Bloomberg APIの利用規約に従ってご使用ください。

🔗 関連ファイル

server.py - stdio版メインサーバー
server_http.py - HTTP/SSE版サーバー
utils.py - ユーティリティ関数
examples.py - 使用例デモ