Fair Value MCP Server

Fair Value

IFRS/IVS に準拠した、OpenCode 向けのプロフェッショナルな財務評価システムです。

mcp-name: com.ascent-partners/fair-value

概要

単一の評価コアを MCP サーバー、REST API、Python ライブラリとして提供します。14 個のネイティブな calculate_* ツール／135 の手法により、IVS 2025 および IFRS/IAS に準拠した企業、スタートアップ、無形資産の評価を網羅します。

• DCF／NAV／CCA／残余利益、マーケット・マルチプル、資本コスト（WACC、Fama-French 5-Factor、ビルドアップ法）
• オプション、債券（期間構造カーブ）、転換社債、ストラクチャード・プロダクト
• IFRS 9／HKFRS 9 の信用リスク（ECL、PD/LGD、CVA/DVA）、保険数理上の現在価値（IFRS 17、IAS 19、IAS 37）
• 公正価値調整（IFRS 13）、期待値、赤字企業向け手法

すべての結果は、中心値、solution_type、statistics（σ／パーセンタイル、および一部の確率的手法で生成されたシード付きサンプル）、原文の IVS／IFRS 条項を参照する citations を含む、決定論を優先した形式で提供されます。135 手法中 120 手法に基準の引用があり、分類体系に孤立した条項は 0 件です。これらは CI の適合性ゲートで検証されます。

クイックスタート（5 分以内）

最速で利用する方法 — インストール不要です。

• ホスト型 MCP（Streamable HTTP）： https://fair-value.ascent-partners.com/mcp
• ホスト型 REST： https://fair-value.ascent-partners.com/v1/health
• フロントページとドキュメント： https://fair-value.ascent-partners.com/
• インストールせずにローカル実行： uvx --from "fair-value[mcp]" fair-value-mcp

続いて、14 個の calculate_* ツールのいずれかを呼び出します（生成された透明性記録を表示するには -help または help=true を追加してください）。クライアントの設定については、MCP サーバーを参照してください。

アーキテクチャ

flowchart LR
  CLIENT["AI agent / OpenCode"] -->|"stdio (uvx) or Streamable HTTP"| MCP["fair-value-mcp<br/>14 calculate_* tools · 135 methods"]
  HOST["Hosted · fair-value.ascent-partners.com<br/>docs/landing at / · MCP at /mcp · REST at /v1"] --> CLIENT
  MCP --> REG["method-spec registry<br/>(valuation://methods)"]
  REG --> STD["standards taxonomy + corpus<br/>IVS 2025 · IFRS/IAS · (valuation://standards)"]
  REG --> CORE["valuation engine<br/>DCF · NAV · CCA · WACC (FF5) · derivatives<br/>credit risk · actuarial"]
  CORE --> DATA["inputs from apdb-etl (cited)"]
  CORE --> ENV["result envelope<br/>value + statistics + citations"]

インストール

pip install -r requirements.txt   # dev workflow
# or, as a package:
pip install .                     # base library
pip install ".[mcp]"              # + MCP server dependencies (fastmcp)

コンソールコマンド fair-value-mcp で MCP サーバーを起動します（stdio。Streamable HTTP を使用するには --http を追加してください）。

MCP サーバー

# run locally without installing (stdio)
uvx --from "fair-value[mcp]" fair-value-mcp

# or install and run
pip install "fair-value[mcp]"
fair-value-mcp            # stdio
fair-value-mcp --http     # Streamable HTTP

サーバーは、DCF、資本コスト、マーケット・マルチプル、残余価値／資産評価、オプション、期待値、信用リスク、保険数理上の現在価値、セクター指標、公正価値調整、転換社債、ストラクチャード・プロダクト、赤字企業、債券にわたる、14 個のネイティブな calculate_* ツールを公開します。すべてのツールは、1 つの手法仕様レジストリから導出されています。ツールに -help（または help=true）を追加すると、数式の参照情報、入力項目、適用される条項を含む生成ドキュメントを表示できます。

採用目標： 初回リリースから 90 日以内に、PyPI ダウンロード数 100 件以上、ディレクトリ掲載 1 件以上を達成します（PyPI 統計 API とディレクトリ掲載状況で追跡）。

REST API

同じコアを /v1 で公開します（mcp_server.asgi:app を通じて MCP と併せて提供）。

curl -s localhost:8000/v1/health
curl -s -X POST localhost:8000/v1/calculate/calculate_dcf \
  -H 'content-type: application/json' \
  -d '{"method":"dcf","cash_flows":[100,110],"discount_rate":0.1}'

エンドポイント：/v1/health、/v1/tools、/v1/methods、/v1/standards、/v1/openapi.json、/v1/docs（Swagger UI）、/v1/help/{tool}、POST /v1/calculate/{tool}。詳しくは REST API を参照してください。

Web フロントエンド（Next.js）

ホストドメインでは、Next.js のフロントエンドとして、ランディングページ、全ドキュメント、手法カタログ（手法ごとに 1 ページ）、基準ブラウザー、API プレイグラウンドを提供します。これらは MCP／REST の機能とともに、1 つの Vercel プロジェクトで動作します。データ駆動型であり、ビルド時にレジストリからカタログを生成します（scripts/gen_web_data.py → data/catalog.json）。

pnpm install
pnpm dev          # http://localhost:3000  (expects /v1 from the API for the playground)
pnpm build        # prebuild regenerates data/catalog.json
pnpm typecheck && pnpm lint

ルーティング：/ と /docs/* は Next.js、/mcp と /v1/* は Python 関数（api/index.py）にリライトされます。フロントエンドはローカライズされており、en は /、zh は /zh、hk は /hk で提供されます。hreflang を設定したロケール別のルートレイアウトを使用します。

クイックスタート（Python）

from valuation_engine import run_valuation

result = run_valuation('9988.HK', 'dcf')  # DCF valuation (shared envelope)

規格と引用

規格との整合性はコードではなくデータです。standards/taxonomy.json は各手法を IVS および IFRS／IAS の条項に対応付け、standards/source/*.md には条項の原文（版と出典は standards/provenance.json に記録）を格納し、standards/coverage-baseline.json はカバレッジの基準です。エンジンはすべてのエンベロープに solution_type と citations を付与し、公開済みの手法から引用が失われたり、タクソノミー／コーパスにずれが生じたりすると、scripts/check_conformance.py が CI を失敗させます。規格リファレンスを参照してください。

モジュール構成

flowchart LR
  SEED["method_spec_seed.py<br/>method tables · 135 methods"] --> SPEC["method_spec.py<br/>parameter vocabulary"]
  SPEC --> SURF["tool_surface.py<br/>15 calculate_* tools"]
  SPEC --> STD["standards.py<br/>taxonomy · citations"]
  SURF --> SRV["server.py (FastMCP)"]
  SRV --> STDIO["stdio · uvx fair-value-mcp"]
  SRV --> HTTP["Streamable HTTP · fair-value-mcp --http"]
  ASGI["asgi.py (+ rest.py, openapi.py)"] --> HOST["Hosted · / + /v1"]
  SRV --> DOCS["docs.py<br/>-help transparency records"]
  STD -.->|resources| RES["valuation://methods · valuation://standards"]
  SRV -.-> DOCS

src/
├── constants.py            # standards references
├── valuation/              # DCF, NAV, CCA, asset standards (relief-from-royalty, MPEEM, residual)
├── cost_of_capital/        # WACC, FF5, KMV
├── credit_risk/            # ECL, PD/LGD, CVA/DVA
├── derivatives/            # options, swaps, convertible bonds, structured products, fixed income
└── output/                 # shared result envelope (value + statistics + citations)
mcp_server/
├── method_spec.py + method_spec_seed.py   # single source of truth for tools/methods
├── standards.py                           # taxonomy loader, citations, coverage
├── tool_surface.py · engine.py · handlers.py · server.py
├── docs.py · rest.py · openapi.py · asgi.py
└── catalog.py · prompts.py                # valuation:// resources + guided prompts
standards/                                 # taxonomy.json · source/*.md · provenance · baseline
scripts/                                   # check_conformance.py · gen_docs.py

リクエストのライフサイクル

sequenceDiagram
    autonumber
    participant C as MCP / REST / Python caller
    participant E as validation + dispatch
    participant R as method-spec registry
    participant S as standards taxonomy
    participant M as computation modules (src/)
    participant O as output envelope
    C->>E: calculate_*(...) / POST /v1/calculate/*
    E->>R: resolve method + validate parameters (no defaults)
    R-->>E: method spec
    E->>M: dispatch to valuation / cost_of_capital / credit_risk / derivatives
    E->>S: attach solution_type + citations
    M-->>E: value + steps + assumptions
    E->>O: ok() / error() envelope (value · statistics · citations)
    O-->>C: status · method · value · statistics · assumptions · citations · disclaimer

開発

CI とデプロイは APG ワークベンチパイプラインを通じて実行されます。

要件

• Python 3.10+
• pandas、numpy、scipy、python-dateutil
• fastmcp（MCP extra）、openpyxl、pdfplumber、python-docx
• QuantLib、pandas_datareader、pytesseract／easyocr（すべて任意で、ネイティブのフォールバックあり）

ドキュメント

• ドキュメントサイト：mkdocs build（mkdocs.yml を参照）；メソッドリファレンスは scripts/gen_docs.py で自動生成されます
• MCP サーバーと REST · REST API · ホスティング
• 手法 · 規格リファレンス · ステータスとロードマップ
• SKILL.md — 機能仕様；valuation://methods / valuation://standards — 機械可読なカタログ

規格への準拠

• IVS 2025 — 国際評価基準（103、105、210、220、230、300、400、410、500）
• IFRS 13 公正価値測定；IFRS 9 金融商品；IFRS 16 リース；IFRS 17 保険契約
• IAS 36 資産の減損；IAS 19 従業員給付；IAS 37 引当金、偶発債務および偶発資産

ライセンス

MIT ライセンスの下で公開されています。