必要なもの
- Python 3.10–3.13
- このチュートリアルではAPIキー不要（yfinance + FRED の無料ティアを使います）
- Claude Desktop — もしくは MCP 対応の任意のクライアント（Cursor、Windsurf、自作のエージェントなど）
ステップ 1: インストール
pip install openbb openbb-yfinance openbb-federal-reserve openbb-fmp openbb-mcp-server
openbb はコアとなるプラットフォームです。プロバイダー拡張によりデータソースが追加されます — 無料データの yfinance と Federal Reserve、そしてよりリッチな株式・オプションのカバレッジのための FMP（詳細は下記）。openbb-mcp-server はそれらすべてを MCP サーバとして包み込みます。
インストール後、ODP が拡張を検出するために使う静的アセットを再ビルドします：
openbb-build
これは、拡張のインストールまたは削除の後に 1 回だけ実行されます。
ステップ 2: FMP を設定（株式とオプションのデータ用）
yfinance と Federal Reserve はセットアップ不要で無料です。FMP は無料の API キーが必要です。こちらで取得できます：financialmodelingprep.com.
入手したら、~/.openbb_platform/user_settings.json に追加します（ファイルが存在しなければ作成）：
{
"credentials": {
"fmp_api_key": "YOUR_FMP_API_KEY"
}
}
または環境変数として設定します：
export FMP_API_KEY=YOUR_FMP_API_KEY
ステップ 3: データレイヤーを確認する
MCP に触る前に、データが動いていることを確認してください：
from openbb import obb
# Treasury yield curve via Federal Reserve
rates = obb.fixedincome.government.treasury_rates(provider="federal_reserve")
print(rates.to_df())
満期ごとの利回りの表が表示されるはずです。ポイントは網羅性です。株式、固定利付（フィクストインカム）、マクロ、オプション、ETF のフロー、FRED、IMF — すべてが 1 つの標準化されたインターフェースです。
ステップ 4: MCP サーバを起動
openbb-mcp
デフォルトでは streamable-http トランスポートで http://127.0.0.1:8001 に起動します。インストール済みの各 ODP エンドポイントは、すぐに MCP ツールとして利用可能になります — 手動でツール定義を行う必要はありません。
リモート利用はどうする？ VPS 上でサーバを動かし、エージェントがネットワーク経由で接続するなら、すべてのインターフェースにバインドします：
openbb-mcp --host 0.0.0.0 --port 8080
その後、エージェントはローカルホストではなく http://your-server:8080/mcp/ に接続します。同じ ODP サーバを複数のエージェントで共有したい場合や、ローカルマシンとは独立して常時動作するエンドポイントを用意したい場合に便利です。
さらに、公開するデータカテゴリを制限することもできます — ツールセットを絞り込んでおきたいときに便利です：
openbb-mcp --default-categories equity,fixedincome,economy
ステップ 5: クライアントを接続する
Claude Desktop
設定ファイルに追加します：
-
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"openbb-mcp": {
"command": "uvx",
"args": [ "--from", "openbb-mcp-server", "--with", "openbb", "openbb-mcp", "--transport", "stdio"]
}
}
}
uvx（pip install uv）が必要です。Claude Desktop を再起動してください — ツールはハンマーパネルに表示されます。
Claude Code
まずサーバを起動し、その後登録します：
claude mcp add --transport http openbb-mcp http://localhost:8001/mcp/
Claude Code 内で /mcp により確認します。すべてのプロジェクトで利用可能にするには：
claude mcp add --transport http --scope user openbb-mcp http://localhost:8001/mcp/
Codex
リポジトリのルートにある .mcp.json に追加します：
{
"mcpServers": {
"openbb-mcp": {
"type": "http",
"url": "http://localhost:8001/mcp/"
}
}
}
Codexは次回の起動時に自動的にそれを取り込みます。
Step 6: これが実際に必要になるようなことを聞いてみる
実行する価値のあるプロンプトはこちらです:
マルチアセットのマクロ質問:
"過去6か月における2年物と10年物の米国債利回りを比較してください。このカーブはまだ逆イールドのままですか？現在のスプレッドはどのようになっていますか？"
セクターローテーション:
"SPY、XLK、XLF、XLE、XLV、XLIの過去30日分の価格履歴を取得してください。どのセクターが指数を上回り、どのセクターが遅れていますか？"
コモディティのポジショニング:
"金（gold）の最新のCFTC「投機筋の建玉報告（Commitment of Traders）」を取得してください。商業部門はネットショートですか、それともネットロングですか？それは歴史的に何を示唆しますか？"
クロスアセットの相関:
"過去1年の金スポット価格とDXY（USD指数）を取得してください。想定どおり、逆方向に動いていますか？"
Claudeは関連するOpenBB MCPツールを呼び出し、実データを取得して、それをもとに推論します――数値を作り話で捏造せず、古い学習データを出さず、あなたが尋ねる時点のライブな市場ソースから取得します。
これが違いです。「『Appleの価格は？』」ではありません。誰でもGoogleすれば済む話です。重要なのは、「複数のソースにまたがる実データを使って、このことを考える手助けをして」と頼むことです。
ここから先はどこへ
プロバイダーを追加する。 yfinanceは単なる出発点です。ODPには、Alpha Vantage、Polygon、FRED、米国労働統計局（Bureau of Labor Statistics）、IMFなどの拡張機能があります。それらをインストールすれば、同じMCPサーバー経由で即座に利用できるようになります――コード変更は不要です。
自分のデータをつなぎ込む。 ODPの拡張システムでは、任意の社内APIや独自のデータセットをプロバイダーとしてラップできます。データを「変換（transform）クエリ」「データ取得（fetch data）」「レスポンス変換（transform response）」の3つのメソッドとして説明できるなら、pip install 1回でMCP対応のツールになります。
エージェント向けにデプロイする。 サーバー上で openbb-mcp --host 0.0.0.0 を実行し、あなたの自律エージェントを http://your-server:8001/mcp/ に向ければ、常駐のクエリ可能な金融データ層を要求に応じて利用できます――ローカルプロセスの監視をあなたがする必要はありません。
まとめ
MCPの本当の価値は「Claudeに『テスラがいつ終値いくらだった？』と聞けること」ではありません。AIエージェントが、答えが推論を必要とするほど複雑な金融データへ、構造化されリアルタイムにアクセスできるようにすることです――同時に、取引対象（銘柄・指標）、期間、データソースをまたいで。
ODPはそのための最もきれいな道筋です。インストールして、作って、動かす。それ以外は後からついてきます。
FonnITでは、まさにこの種のスタックでプロダクションツールを構築しています。チーム向けにカスタムの金融データ・パイプラインやAIリサーチツールがどのようなものになるか考えているなら――ぜひお話しましょう。
