Valuation Skills MCP Server

io.github.simonmak-ascentv0.1.1更新於 Oct 3, 2026

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

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓助理執行 DCF、NAV、CCA 等財務估值、衍生品定價,並審查估值模型與報告。

功能
它提供估值工具,涵蓋 DCF、NAV 與 CCA 方法、包含 Fama-French 五因子與 WACC 的資金成本計算、KMV 信用風險模型,以及選擇權、交換與可轉換公司債的衍生品定價。它也能審查 Excel 模型,分析 PDF、Word 與圖片文件,並以資源形式提供機器可讀的方法目錄。它同時委派 startup-valuation 與 intangible-valuation 工具家族,因此是兩者的超集。
適用情境
當助理需要產出或查核公允價值工作時適合加入:對某個股票代號執行 DCF 或 NAV 估值、計算權益成本或 WACC、為衍生品定價、估算信用風險,或依準則審查既有的 Excel 估值模型。
執行需求
以 stdio 程序在本機執行,可用 uvx 從 fair-value[mcp] 套件啟動,或透過 pip 安裝。需要 Python 3.8+ 及 yfinance、pandas、numpy、scipy、QuantLib-Python、openpyxl、pdfplumber、python-docx 等相依套件。未宣告任何帳號、API 金鑰或環境變數;市場資料透過網路從 yfinance 取得。
安裝前請注意
審查 Excel、PDF、Word 或圖片文件時會讀取本機檔案,因此只應指向你願意暴露的目錄。市場資料來自第三方服務 yfinance。輸出是用於估值工作的分析性估算,並非投資建議,採用前應加以核對。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Valuation Skills 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.1.1最新Oct 3, 2026