关于 pyeconomics
pyeconomics 为分析师、研究人员和开发者提供经过测试并附有引用的经济与金融模型及数据。结果附带可复现的来源清单,并可通过 Python、命令行、REST、MCP 和导出接口访问。
主要功能
- 0150 类经济与金融模型
- 02来自 31 个提供方的数据
- 03带单位和边界的类型化输入
- 04每项结果均附来源清单
- 05通过 Python、命令行、REST 和 MCP 访问
- 06表格与可复现性包导出
适用场景
- 01运行带引用的金融和经济模型
- 02通过实时绑定获取数据概念
- 03复现并审查模型结果
MCP 相关
可选的 MCP 服务向 MCP 客户端提供 pyeconomics 模型和数据。可通过文档所述的扩展安装 MCP 支持,也可使用 `uvx` 运行服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
pyeconomics
状态:1.0.0b1 是 PyPI 上的 Beta 预发布版。 请使用
pip install --pre pyeconomics==1.0.0b1显式安装(需要 Python 3.12 或更高版本)。 直接运行pip install pyeconomics仍会安装稳定版 0.2.6。 在 1.0.0 正式发布前,预发布版本不承诺稳定性。
pyeconomics 提供 50 个经过测试并附有引用的经济学和金融模型系列,涵盖 13 个领域:基础、固定收益、衍生品、国际、股票、公司、会计、投资组合、绩效、风险、计量经济学、宏观经济学和资产定价。数据平台还提供 31 个数据提供方、171 个目录概念,以及带有实时版本的动态绑定。所有模型均可通过 Python API、pyeconomics 命令行、REST API(pyeconomics serve)、MCP 服务(pyeconomics mcp)以及表格或可复现性数据包导出,以相同方式调用。带类型的输入会声明单位和范围;每个结果都包含可复现的溯源清单。利率和百分比使用小数表示:0.05 表示 5%。
请参阅 1.0 文档预览,了解公式、假设和示例;有关已发布功能和已知限制,请参阅 Beta 版本说明。入门请参阅 CLI 指南、REST API 指南、MCP 服务指南、导出指南、AI 叙述指南、数据指南和密钥指南。使用 pip install --pre "pyeconomics[econometrics,plot,server,mcp]==1.0.0b1" 安装可选的计量经济学、绘图、REST API 和 MCP 支持,或者直接运行 MCP 服务:uvx --from "pyeconomics[mcp]==1.0.0b1" pyeconomics mcp。
此 Beta 版取代 0.2.x API,并在模型引擎和数据平台之上新增命令行、导出和可复现性数据包、REST API、MCP 服务以及可选的 AI 叙述功能。Web 应用将在第 5 阶段推出;项目路线图和架构决策记录了相关计划。请在单独的环境中运行旧版工作负载。
pyeconomics 0.2.x
0.2.6 是 0.2.x 系列的当前稳定版本:基于 FRED 数据的四项货币政策规则。
- 采用 MIT 许可证。源代码位于
legacy/0.2.x分支,文档见 https://pyeconomics.readthedocs.io/。 - 仅接收安全修复,并将在 1.0.0 发布时终止支持。
pyeconomics<1等版本限定仍可正常使用。 - 0.2.0 到 0.2.5 会以 DEBUG 级别记录 FRED API 密钥。请升级到 0.2.6,并轮换这些版本使用过的任何密钥:参见安全公告 GHSA-j6rp-vwwv-jrr8。
请勿与以下项目混淆
本项目不是 davidrpugh/pyeconomics
(2013–14 年计算经济学课程代码),也不是
pyecon.org(教授经济学 Python 的网站)。这三个项目只有名称相同。
贡献与安全
许可证
从 1.0 起,pyeconomics 采用 Apache License 2.0; 另请参阅 NOTICE。 截至 0.2.x(含)的版本仍采用 MIT 许可证。
声明
按现状提供;不构成投资建议。pyeconomics 仅供教育和信息用途,且未在任何监管机构注册。
CFA® 和 Chartered Financial Analyst® 是 CFA Institute 拥有的商标。pyeconomics 与 CFA Institute 无关联,未获其认可,也不是其备考服务提供商。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。