Fair Value MCP Server

io.github.simonmak-ascentv0.2.1更新于 Oct 3, 2026

Valuation MCP: DCF/NAV/CCA, cost of capital, derivatives, credit risk, report review.

已验证STDIO仅桌面Files & StorageFinanceData & Analytics

概览

AI 生成的概览

让助手执行 DCF、NAV、CCA 等专业财务估值，为衍生品定价、建模信用风险并审查估值报告。

功能
它提供原生估值、资本成本、衍生品、信用风险和报告审查工具，并委托 startup-valuation 与 intangible-valuation 工具族，因此是两者的严格超集（R15）。能力包括 DCF、NAV 和 CCA 估值、Fama-French 五因子股权成本、KMV 信用风险模型，以及期权、互换和可转债的衍生品定价（R6-R9）。它还能审查和校验 Excel 模型，并分析 PDF、Word 和图片文档（R10、R11）。机器可读的方法目录通过 valuation://methods 资源提供（R28）。
适用场景
当助手需要真正产出或核查估值而非仅讨论时使用：运行 DCF、NAV 或 CCA 模型，估算资本成本或信用风险，为衍生品定价，或按 IFRS/IVS 类标准审计现有 Excel 估值模型（R2、R5-R11、R30-R33）。适合处理上市公司股票代码和本地报告文件的分析师与财务团队。它不是通用的数据或表格工具。
运行要求
需要本地 Python 3.8+ 运行环境（R20）。从 PyPI 安装带 mcp 附加项的 fair-value，然后运行 fair-value-mcp 命令；也可用 uvx --from fair-value[mcp] fair-value-mcp 免安装运行（R13、R14）。依赖包括 yfinance、pandas、numpy、scipy、QuantLib-Python、openpyxl、pdfplumber 和 python-docx（R21-R26）。获取市场数据需要网络访问。未声明认证、环境变量或请求头。
安装前请注意
该服务器会读取本地文件：报告审查与文档分析会打开 Excel、PDF、Word 和图片文件（R10、R11），scan_directory 会遍历目录（R17），因此只应指向你愿意暴露的文件夹。它通过 yfinance 获取市场数据（R18、R21），会把股票代码发送给第三方数据源。未声明任何凭据、支付或写入操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fair Value MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Fair Value

[PyPI] [CI] [License: MIT] [MCP Registry]

Professional financial valuation system for OpenCode with IFRS/IVS compliance.

mcp-name: io.github.simonmak-ascent/fair-value

Overview

This project provides comprehensive financial valuation capabilities including:

  • DCF, NAV, and CCA valuations
  • Fama-French 5-Factor cost of equity
  • KMV credit risk model
  • Derivatives pricing (Options, Swaps, CB)
  • Excel model review and validation
  • PDF/Word/Image document analysis

Installation

bash
pip install -r requirements.txt   # dev workflow (unchanged)# or, as a package:pip install .                     # base librarypip install ".[mcp]"              # + MCP server dependencies (A-004)

The console command fair-value-mcp runs the MCP server (stdio; add --http for Streamable HTTP).

MCP Server

bash
# run locally without installing (stdio)uvx --from "fair-value[mcp]" fair-value-mcp
# or install and runpip install "fair-value[mcp]"fair-value-mcp            # stdiofair-value-mcp --http     # Streamable HTTP

The server exposes the native valuation, cost-of-capital, derivatives, credit-risk, and report-review tools, and delegates the startup-valuation and intangible-valuation tool families, so it is a strict superset of both.

Adoption target: ≥ 100 PyPI downloads and ≥ 1 directory listing within 90 days of the first release (tracked via the PyPI stats API and the directory listing).

Quick Start

python
from valuation_engine import run_valuation, review_report, scan_directory
# Run DCF valuationresult = run_valuation('9988.HK', 'dcf')
# Review Excel modelreview = review_report('/path/to/model.xlsx')
# Scan for valuation filesfiles = scan_directory('/path/to/reports/')

Module Structure

src/├── constants.py           # Standards references├── fetch_data.py          # Data fetching (yfinance)├── valuation/             # DCF, NAV, CCA├── cost_of_capital/       # WACC, FF5, KMV├── credit_risk/           # ECL calculations├── derivatives/            # Options, Swaps, CB├── report_review/          # Excel, PDF, Word, Image analysis└── output/                # Report formatting

Requirements

  • Python 3.8+
  • yfinance
  • pandas, numpy, scipy
  • QuantLib-Python
  • openpyxl
  • pdfplumber
  • python-docx

Documentation

See SKILL.md for the capability spec; the machine-readable method catalog is served by the MCP server at the valuation://methods resource, and a docs site is configured via mkdocs.yml.

Standards Compliance

  • IVS 2025
  • IFRS 13 (Fair Value Measurement)
  • IAS 36 (Impairment)
  • HKFRS 9 (ECL)

License

Released under the MIT License.

来源：README.md，提交 1f9d1bf

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.2.1最新Oct 3, 2026