pyeconomics について
pyeconomics は、アナリスト、研究者、開発者向けに、テスト済みで出典付きの経済・金融モデルとデータを提供します。結果には再現可能な来歴マニフェストが付き、Python、コマンドライン、REST、MCP、エクスポートから利用できます。
主な機能
- 0150 種類の経済・金融モデル群
- 0231 プロバイダーのデータ
- 03単位と範囲を指定する型付き入力
- 04各結果に来歴マニフェスト
- 05Python、コマンドライン、REST、MCP から利用
- 06表形式と再現性バンドルへのエクスポート
活用シーン
- 01出典付きの金融・経済モデルの実行
- 02ライブバインディングによるデータ概念の取得
- 03モデル結果の再現と監査
MCP 対応
オプションの MCP サーバーは、MCP クライアントに pyeconomics のモデルとデータを提供します。記載された追加機能をインストールするか、`uvx` でサーバーを起動できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
pyeconomics
ステータス:1.0.0b1 は PyPI でベータ版のプレリリースです。 明示的に次のコマンドでインストールしてください。
pip install --pre pyeconomics==1.0.0b1(Python 3.12 以降)。pip install pyeconomicsでは、引き続き安定版の 0.2.6 がインストールされます。 1.0.0 までは、プレリリースの安定性は保証されません。
pyeconomics は、13 の領域(基礎、債券、デリバティブ、国際、株式、企業、会計、ポートフォリオ、パフォーマンス、リスク、計量経済学、マクロ経済学、資産価格)にわたる、テスト済みで出典を明記した経済学・金融モデルファミリーを 50 種提供します。データプラットフォームには、31 のプロバイダー、171 のカタログ概念、リアルタイムのビンテージを備えたライブバインディングが含まれます。すべてのモデルは、Python API、pyeconomics コマンドライン、REST API(pyeconomics serve)、MCP サーバー(pyeconomics mcp)、表形式または再現性バンドルのエクスポートを通じて、同じように利用できます。型付き入力では単位と範囲を指定し、すべての結果に再現可能な来歴マニフェストが付属します。金利と割合は小数で表します。0.05 は 5% を意味します。
数式、前提条件、例については1.0 ドキュメントプレビューをご覧ください。提供される機能と既知の制限については、ベータ版リリースノートをご覧ください。利用を開始するには、CLI ガイド、REST API ガイド、MCP サーバーガイド、エクスポートガイド、AI ナラティブガイド、データガイド、キーガイドをご覧ください。計量経済学、プロット、REST API、MCP のサポートをオプションでインストールするには、pip install --pre "pyeconomics[econometrics,plot,server,mcp]==1.0.0b1 を実行してください。または、uvx --from "pyeconomics[mcp]==1.0.0b1" pyeconomics mcp で MCP サーバーを直接実行できます。
このベータ版では 0.2.x の API を置き換え、モデルエンジンとデータプラットフォームに、コマンドライン、エクスポートと再現性バンドル、REST API、MCP サーバー、オプションの AI ナラティブを追加しています。ウェブアプリはフェーズ 5 で登場します。プロジェクトロードマップとアーキテクチャ決定記録に計画が記載されています。レガシーなワークロードは別の環境で実行してください。
pyeconomics 0.2.x
0.2.6 は 0.2.x 系列の最新の安定版で、FRED データに基づく 4 つの金融政策ルールを提供します。
- MIT ライセンスです。ソースコードは
legacy/0.2.xブランチにあり、ドキュメントは https://pyeconomics.readthedocs.io/ にあります。 - セキュリティ修正のみを受け付け、1.0.0 のリリースをもってサポート終了となります。
pyeconomics<1のようなバージョン指定は引き続き機能します。 - 0.2.0 から 0.2.5 では、FRED API キーが DEBUG レベルでログに記録されます。0.2.6 にアップグレードし、これらのバージョンで使用したキーをすべてローテーションしてください。勧告 GHSA-j6rp-vwwv-jrr8 をご覧ください。
混同しないでください
このプロジェクトは、davidrpugh/pyeconomics
(2013~14 年の計算経済学コースのコード)でも、
pyecon.org(経済学向けに Python を教えるサイト)でもありません。この 3 つは名前を共有しているだけです。
貢献とセキュリティ
- CONTRIBUTING: セットアップ、DCO への署名、コミット規約、モデルの完了条件。
- SECURITY: 脆弱性は非公開で報告してください。公開 Issue では報告しないでください。
- Code of Conduct。
- Changelog。
ライセンス
1.0 以降、pyeconomics は Apache License 2.0 に基づいてライセンスされています。 NOTICE もご覧ください。 0.2.x までのリリースは、引き続き MIT ライセンスです。
注意事項
現状のまま提供されるものであり、投資助言ではありません。pyeconomics は教育および情報提供のみを目的としており、いかなる規制当局にも登録されていません。
CFA® および Chartered Financial Analyst® は、CFA Institute が所有する商標です。pyeconomics は CFA Institute と提携しておらず、同機関による承認を受けておらず、同機関の Prep Provider でもありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。