Fundamental Analysis

fundamental-analysis-mcp

fundamental-analysis の計算機能を AI アシスタントに提供する MCP サーバーです。P/E、DCF、グレアム数、アルトマン Z スコア、ピオトロスキー F スコア、自己資本利益率、利益率、流動性比率、負債比率に加え、入力された数値で計算可能なすべての比率を一度の呼び出しで算出するツールを備えています。

各結果には、値、計算に使った式、入力値、そして判断を下す前に知っておくべき注意事項の 4 つが含まれます。数値はアシスタントが用意します。このサーバーは何も取得せず、API キーも依存関係も必要ありません。

ツール

ツール	返される内容
pe_ratio	株価 / EPS。EPS がゼロまたは負の場合は注記を表示
dcf_valuation	予測フリーキャッシュフローから算出した企業価値、そのうちターミナルバリューが占める割合。負債、現金、発行済み株式数を指定すると理論株価も返します
graham_number	sqrt(22.5 x EPS x 1 株当たり簿価) と、それに対する株価
altman_z_score	Z（上場製造業）または Z''（その他すべて）と、該当するゾーン
return_on_equity	純利益 / 自己資本。自己資本がゼロまたは負の場合は null
piotroski_f_score	0～9 のスコアと 9 つのシグナルそれぞれの評価、および前年度のデータがないため評価されなかったシグナル
profit_margin	売上高に占める粗利益、営業利益、純利益、またはフリーキャッシュフローの割合
liquidity_ratio	流動比率、または在庫を除いた当座比率
leverage_ratio	負債資本比率、またはインタレスト・カバレッジ・レシオ（EBIT / 支払利息）
analyze_company	入力値で計算可能なすべての比率を、バリュエーション、収益性、流動性、支払能力、効率性、リスク、品質に分類して返します。null になった指標の名前も示します。各指標のステータスと 1 行の解釈を追加するには、withInsights を指定します

すべてのツールは読み取り専用です。計算して結果を返すだけで、何も変更しません。

セットアップ

Claude Code：

claude mcp add fundamental-analysis -- npx -y fundamental-analysis-mcp

Claude Desktop（claude_desktop_config.json）と Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "fundamental-analysis": {
      "command": "npx",
      "args": ["-y", "fundamental-analysis-mcp"]
    }
  }
}

使用例

「EPS が 4、1 株当たり簿価が 25、株価が 40 の場合のグレアム数は？」と尋ねると、graham_number ツールが次のように回答します。

{
  "value": 47.43,
  "priceVsGraham": 0.84,
  "formula": "Graham Number = sqrt(22.5 * EPS * book value per share)",
  "inputs": { "eps": 4, "bookValuePerShare": 25, "price": 40 },
  "caveats": ["22.5 is 15 times earnings by 1.5 times book, Graham's limits for a defensive investor. It ignores growth, so it is strict on growth companies and on asset-light businesses."]
}

ビルドとテスト

npm run build   # one file, dist/server.js, with the library bundled in
npx vitest run mcp   # from the repository root

MCP レジストリ

server.json には、公式 MCP レジストリ向けにサーバーが io.github.boffincoders/fundamental-analysis-mcp として記述されています。また、package.json の mcpName にも同じ名前が設定されているため、レジストリは npm パッケージを確認できます。まず npm に公開してから、このフォルダーで mcp-publisher publish を実行してください。

ライセンス

MIT。Boffin Coders がメンテナンスしています。