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