finops-focus-mcp

finops-framework-mcp

公開されているFinOpsおよびAIコストに関するガイダンスを、構造化された出典付きの形式でAI アシスタントに提供する、非公式のMCPサーバーが3つあります。アシスタントは即興で答えるのではなく、公開元の実際の文章や数式を使って回答できます。

サーバー	対象	出典
finops-framework-mcp	FinOps Framework：ケイパビリティ、Crawl/Walk/Runの成熟度、KPI、ペルソナ	finops.org/framework
finops-focus-mcp	バージョンごとに固定されたFOCUSの請求データ仕様（1.0、1.2）	focus.finops.org
tokenomics-overview-mcp	AIトークノミクス：Seven-Layer Stack、Big-T表記、プロンプトキャッシュの指標、モデルルーティングを含む消費の調整要因、FOCUS 1.5のAIコスト	tokeneconomics.com

3つとも読み取り専用です（エージェントはガイダンスを読めますが、プラクティスやデータを変更することはできません）。また、インストール後はオフラインで動作します（実行時のネットワークアクセスやテレメトリはありません）。どれか1つだけでも使えます。組み合わせれば、望ましい状態、その証明に使える請求データの列、AIトークンコストを左右する要因を網羅できます。

まずはこちら：利用ガイド

aaronmsoto.github.io/finops-framework-mcp は、エンジニアだけでなくFinOpsの実務担当者向けに書かれた、無料でインストール不要のガイドです。各サーバーの機能を説明し、数分でClaudeに接続する方法を紹介し、ショーバックレポートからプロンプトキャッシュの効果検証まで、5つの例を順に解説します。掲載されている数値や引用はすべて、これらのサーバーを実際に実行して得られたものです。ページ一覧はドキュメントをご覧ください。

開発の背景

これらのサーバーを使わずにAIアシスタントに「当社のAllocationプラクティスの成熟度はどのくらいですか？」「Effective Savings Rateの算出に使うFOCUSの列はどれですか？」「プロンプトキャッシュの効果は出ていますか？」と尋ねると、もっともらしい回答を即興で返すことがあります。これらのサーバーを使えば、すべての回答が公開元自身の文章や数式に基づき、アシスタントが読み取れる構造で、出典URLとライセンスも添えて提供されます。

サーバーが独自に算出した内容にはすべてラベルが付いており、公開済みのガイダンスとして提示されることはありません。

• FOCUSサーバーのKPIと列の対応付け、算出されたKPI値、バージョン間の差分には、UNOFFICIAL（official: false）のマークが付いています。
• トークノミクスサーバーは、各回答に出典ごとの公開状況を示します。Tokenomics Foundationのガイダンスの多くは、作業中のドラフトまたはリリース候補であるためです。厳選されたクロスウォークは非公式で、FINOPS_MCP_EXPERIMENTAL=1の場合にのみ表示されます。
• Frameworkサーバーは、初期状態では公式情報のみを扱います。ケイパビリティ間の関係を独自に作り出したり、FoundationのCrawl/Walk/Runを超える成熟度レベルを示したりすることはありません。

クイックスタート

3つとも npm で提供されているため、クローンやビルドは不要です。各パッケージには独自のデータが含まれており、オフラインで動作します。必要なのは Node >= 22 のみです。

npx -y finops-framework-mcp
npx -y finops-focus-mcp
npx -y tokenomics-overview-mcp

（-y を指定すると、npx の初回インストール確認がスキップされます。確認があると、非対話型の MCP クライアントでは処理が停止することがあります。たとえば npx -y [email protected] のようにして、バージョンを固定できます。）

Claude Code:

claude mcp add finops-framework -- npx -y finops-framework-mcp
claude mcp add focus-spec -- npx -y finops-focus-mcp
claude mcp add tokenomics-overview -- npx -y tokenomics-overview-mcp

Claude Desktop（claude_desktop_config.json）、プロジェクト単位の .mcp.json、または任意の stdio MCP クライアントの場合：

{
  "mcpServers": {
    "finops-framework": {
      "command": "npx",
      "args": ["-y", "finops-framework-mcp"]
    },
    "focus-spec": {
      "command": "npx",
      "args": ["-y", "finops-focus-mcp"]
    },
    "tokenomics-overview": {
      "command": "npx",
      "args": ["-y", "tokenomics-overview-mcp"]
    }
  }
}

環境変数（すべて任意）：

変数	サーバー	効果
FINOPS_MCP_DATA	framework	パッケージに含まれる data/framework の代わりに、ローカルで更新したアーティファクトを使用します
FOCUS_MCP_DATA	FOCUS	data/focus に対して同様に使用します
TOKENOMICS_MCP_DATA	tokenomics	data/tokenomics に対して同様に使用します
FINOPS_MCP_EXPERIMENTAL=1	framework, tokenomics	非公式の追加機能を明示的にラベル付けして有効にします。framework の解析済み成熟度 get_actions と、tokenomics のクロスウォークが対象です

各サーバーは、最初の CLI 引数としてデータディレクトリを指定することもできます。また、--version を指定すると、パッケージのバージョンとデータのバージョンを返します（FOCUS の場合は、提供する仕様のバージョンです）。

使用方法

各サーバーのエントリーポイントでセッションを開始し、提案に沿って操作します。

サーバー	最初に実行	次に実行
framework	get_framework_info {}	search_framework、list_capabilities、get_capability（サイズを調整するには include を指定）、get_kpis、assess_maturity_path
FOCUS	list_versions {}	search_focus、get_column、get_requirements、compare_versions、get_kpi_mapping、calculate_kpi
tokenomics	get_tokenomics_info {}	list_layers、get_bigt_notation、list_levers、get_metric、calculate_cache_metrics、get_crosslinks

それぞれのサーバーが得意とする質問：

• Framework: 「Walk レベルの Forecasting には何が必要ですか？」「Rate Optimization の Foundation 機能には、どの KPI が含まれていますか？」「Anomaly Management では誰が何を担当しますか？」
• FOCUS: 「1.2 における BilledCost の意味と、1.0 からの変更点は何ですか？」「Effective Savings Rate の計算には、どの列が必要ですか？」
• Tokenomics: 「モデルルーティングと AI ゲートウェイを担当するレイヤーはどれですか？」「このエージェントのトークン使用量は、自律性に応じてどのように増加しますか？」「キャッシュ読み取り、書き込み、キャッシュなしの入力トークン数が X、Y、Z の場合、キャッシュでコストを削減できていますか？」

組み合わせて使う場合。 各サーバーは個別に提供され、相互に呼び出すことはありません。代わりに、回答は URI を介して引き継がれます。tokenomics サーバーの 35 個の get_crosslinks リンクは、それぞれ Tokenomics Foundation ページからの逐語的な引用によって裏付けられており、エージェントが他の 2 つのサーバーで参照できる finops://framework/… または focus://spec/… の URI を含みます。まだ批准されたリリースに含まれていない FOCUS 1.5 の作業ドラフトの名称には、URI が返されません。プロンプトキャッシュの例では、1 つの質問を 3 つすべてのサーバーで処理する手順を紹介しています。

サーバーが提供する機能

• finops-framework-mcp：11 個のツール — get_framework_info（エントリーポイント）、 search_framework、list_capabilities、get_capability、 get_maturity_assessment、get_kpis、assess_maturity_path、 map_personas、get_entity、get_maturity_model、get_changelog — に加え、 finops://framework/… リソースと 4 つのプロンプト（explain-framework、 assess-capability-maturity、plan-maturity-roadmap、 map-personas-to-capabilities）。データ：6 つの原則、3 つのフェーズ、4 つの ドメイン、22 のケイパビリティ、11 のペルソナ、5 つのテクノロジーカテゴリー、 スコープの概念、88 項目の KPI ライブラリ。
• finops-focus-mcp：列と属性の検索、規範的要件、検索、1.0 → 1.2 の差分、 サンプルデータを使った KPI 計算を含む非公式の KPI と列のマッピングのための 9 つのツールに加え、focus://spec/… リソースと 3 つのプロンプト。詳しくは packages/finops-focus-mcp を参照してください。
• tokenomics-overview-mcp：ドキュメント、Seven-Layer Stack、Big-T 記法、 レバー、メトリクス（キャッシュメトリクス計算ツール付き）、ペルソナ、価値分類、 FOCUS 1.5 の AI コスト関連ケイパビリティと相互リンクを扱う 20 個のツールに加え、 tokenomics://overview/… リソースと 3 つのプロンプト （optimize_consumption、assess_prompt_caching、bigt_review）。データ： 14 件のソースドキュメント、7 つのレイヤー、6 つの Big-T クラス、32 のレバー、 7 つのメトリクス、12 のペルソナ、明記された 35 件の相互リンク。詳しくは packages/tokenomics-overview-mcp を 参照してください。

3 つすべてのサーバーのプロンプト、リソース、ツール（名前、引数、URI、デフォルト値、 制限）の全容は、ライブ MCP 出力から docs/mcp-surface.md に生成されます。

リモートオプション：Cloudflare Worker

3 つすべてのサーバーは、単一のバンドル済み Cloudflare Worker （src/workers/、エンドポイント /mcp/framework、/mcp/focus、 /mcp/tokenomics。詳しくは docs/deploy-worker.md を 参照してください）から Streamable HTTP 経由で実行することもできます。 Streamable HTTP に対応する MCP クライアントなら、デプロイ済み Worker に接続できます。 例：

claude mcp add --transport http tokenomics-overview "$WORKER_URL/mcp/tokenomics"

Worker はステートレスで、各サーバーのデフォルトの機能セット（実験的なツールなし）を 提供します。demo/ は静的なブラウザーページで、2 つのウォークスルーを 実行できます：「プロンプトキャッシュは効果を上げているか？」（3 つすべてのサーバーを 使い、独自のトークン数を使用）と料金の最適化（framework と FOCUS）。

構築方法

各サーバーは、疎結合の同じ 3 つの部分で構成されているため、コンテンツを更新する際に コードを変更する必要はありません。

crawler ──▶ data artifact ──▶ MCP server (stdio)
src/crawlers/<name>   data/<name>/   src/servers/<name>

framework、focus、tokenomics の <name> が対象です。framework と tokenomics のクローラーは、取得 → 解析 → 構成 → 派生 → 検証 → 出力の順に 処理します。content/markdown/ は解析した HTML から構成される正規の 中間形式で、すべての JSON ファイルはオフラインの derive ステップでここから 再生成されます。そのため、スキーマや JSON だけの修正であれば、再クロールは不要です。 生成物には JSON Schemas と sha256 マニフェストが含まれ、各サーバーは起動時に 生成物を検証し、不正な場合は起動を拒否します。FOCUS クローラーはこれとは異なり、 ピン留めされた各仕様リリースを git タグから data/focus/<version>/ に取り込み、 派生差分と KPI マッピングを data/focus/derived/ に格納します。

framework サーバーの初期のケイパビリティ関係グラフ （get_prerequisites／get_related）は、構築・評価されましたが、エッジの精度が 基準に達しなかったため削除されました。詳しくは .agents/specs/v1-official-only.md を参照してください。

データの更新

npm run build
npm run refresh                                   # framework: crawl → artifact + diff report
node dist/crawlers/focus/cli.js                   # FOCUS: ingest the pinned spec tags (1.0, 1.2)
node dist/crawlers/tokenomics/cli.js refresh      # tokenomics: Tokenomics Foundation pages
node dist/crawlers/framework/cli.js derive        # framework: offline markdown → JSON, byte-identical
node dist/crawlers/tokenomics/cli.js derive       # tokenomics: same, for data/tokenomics

クロールは礼儀正しく、キャッシュを利用し、robots のルールに従います。上流に変更が なければ、バイト単位で同一の生成物となり、バージョンは更新されません。コンテンツに 変更があれば、変更履歴のエントリーが追加され、データバージョンの semver が更新 されます。tokenomics の更新では、発見したものの取り込まなかったページ（作業部会の ドラフトなど）も、マニフェスト内の unregistered に記載されます。定期更新の ワークフローは docs/proposed/refresh-data.yml に用意されています。この リポジトリでは .github/workflows/ が保護対象のパスであるため、所有者が インストールします。

git mv docs/proposed/refresh-data.yml .github/workflows/refresh-data.yml

データのバージョン管理ポリシー

利用者は、パッケージのバージョンまたはこのリポジトリの Git ref を固定することで、データのバージョンを固定します。各 manifest.json には、data_version、schema_version、crawled_at、ファイルごとの sha256、エンティティ数が記録されています。derived/changelog.json にはバージョン間の変更内容が記録され（フレームワークサーバーから get_changelog として提供されます）、スキーマを破壊する変更では schema_version を上げ、サーバーのリリースが必要になります。リリースは v* タグから作成します。詳しくは docs/release-runbook.md をご覧ください。

ライセンスと帰属表示

コード：MIT（LICENSE を参照）。コンテンツ：各 CC BY 4.0 のライセンスに基づき、構成を変更して翻案しています。必要な帰属表示と変更に関する記載については、NOTICE.md をご覧ください。

• data/framework/**：© FinOps Foundation
• data/focus/**：© FinOps Foundation / FOCUS project contributors
• data/tokenomics/**：© Tokenomics Foundation (a Series of LF Projects, LLC)

FinOps™、FinOps Foundation™、FOCUS™ は FinOps Foundation の商標です。このプロジェクトは独立したものであり、FinOps Foundation、FOCUS project、Tokenomics Foundation との提携や、これらからの承認を受けていません。

ドキュメント

docs/guide/ は使用ガイドです。自己完結した9つのページで構成されており、すべての数値、引用、会話記録は、これらのサーバーを実際に調査して取得したものか、コミット済みのサンプルデータから算出したものです。公開サイトも兼ねており、.github/workflows/pages.yml は、main へのプッシュで docs/guide/ に変更があった場合に、このディレクトリだけを https://aaronmsoto.github.io/finops-framework-mcp/ にデプロイします（セットアップとスモークテストについては docs/deploy-pages.md を参照してください）。

ページ	内容
はじめにとスタートガイド	3つすべてのサーバーを並べて紹介。インストール、Claude Code / Claude Desktop / .mcp.json の設定、Worker リモートオプション、各サーバーへの最初の呼び出し
Framework MCP リファレンス	データモデル、用途別にまとめた11のツール、プロンプトとリソース、ページネーション、異常管理のデモ
FOCUS MCP リファレンス	バージョンモデル、9つすべてのツール、focus:// リソース、BilledCost の詳細解説、1.0→1.2 の差分
Tokenomics MCP リファレンス	データソースとそのステータス、Seven-Layer Stack と Big-T、20すべてのツール、プロンプト、tokenomics:// リソース、相互リンク、モデルルーティングと AI ゲートウェイのデモ
ショーバックレポート	配分 + レポートと分析 → ショーバックに必要な FOCUS の列 → 公式サンプルから算出したレポート
料金最適化（ESR）	機能 → 主な KPI → 1.0 と 1.2 の FOCUS 列 → 公式サンプルの実効節約率
予測の進め方	Walk レベルの予測に至る成熟度の道のり：公式の Crawl / Walk 特性、KPI、予測に使うデータ
クイック Q&A	Framework サーバーと FOCUS サーバーを横断する1回のセッションで、台本なしに行う4つのライブプロンプト
プロンプトキャッシュは効果を上げているか？	3つすべてのサーバー：Framework の Cache Hit Rate KPI → 2つのワークロードで見る Tokenomics の計算式と計算ツール → FOCUS 1.2 および 1.5 でのキャッシュ済みトークンデータの場所

各ページは file:// からも開けます。ガイドに外部アセットはありません。ガイドのページがリッチ HTML なのは意図的であり、このリポジトリのドキュメントでは Markdown を使う慣例の例外として .agents/memory/decisions.md に記録されています。

開発

• エージェント向け指示：AGENTS.md · 設計：docs/architecture.md （敵対的レビュー：docs/critique-1.md、docs/critique-2.md、 docs/critique-3-publish-gate.md、docs/critique-4-focus-gate.md、 docs/final-status-review.md）· トークノミクス設計： docs/designs/tokenomics-overview-mcp.html
• ゲート：./scripts/agentic gates · テスト：npm test（フィクスチャベース、ネットワーク不要）· 評価： evals/framework/（docs/eval-results.md）
• クローンでの作業：チェックイン済みの.mcp.jsonは、それを読み込むMCPクライアントで3つすべてのサーバーを読み込み、公開済みパッケージをnpx経由で実行するため、新しいクローンでもビルドせずに動作します。作業ツリーを使って試すには、.mcp.json.exampleを.mcp.jsonにcpしてから先にビルドし（dist/はgitignore対象です）、クライアントを再起動してください。クライアントがMCP設定を読み込むのは起動時のみです。CONTRIBUTING.mdを参照してください。
• リリース：docs/release-runbook.md。