fm-mcp

fm-mcp

Claude Code や Codex などのコーディングエージェントが、簡単なテキスト作業を Apple Foundation Models のオンデバイスモデル（macOS 27 に付属する fm）に任せられる MCP サーバーです。無料で、プライバシーが保護され、オフラインで動作します。

mcp-name: io.github.yrangana/fm-mcp

サイト： yrangana.github.io/fm-mcp、および 開発を通じて得た知見：オンデバイスモデルの実測された限界をご覧いただけます。

AI アーキテクト兼 AI エンジニアの Yasiru Rangana（シドニー）が作成しました。

理由

コーディングエージェントは、ログの要約やドキュメントからの項目抽出など、簡単な作業にも有料のリモートトークンを消費します。Mac にすでに搭載されている小型モデルなら、そうした作業の多くを無料で実行でき、テキストがマシンの外に出ることもありません。fm-mcp を使うと、エージェントはその作業を委任でき、小型モデルにできないことも明確に伝えられます。

インストール

fm-mcp はパブリックベータ（0.1.x）です。動作し、テスト済みですが、リリースによってツールの詳細が変わる場合があります。変更内容は CHANGELOG.md に記載されています。

Apple Silicon 搭載の Mac（Intel Mac はサポート対象外）、Apple Intelligence が有効になった macOS 27、および一度承認した fm ライセンス（fm license）が必要です。サポート対象はこれらのみです。fm-mcp doctor はそれぞれを確認しますが、それ以外はサポートされません。

Homebrew がまだインストールされていませんか？ まず brew.sh からインストールしてください。インストーラーから Xcode のコマンドラインツールをインストールするよう求められたら、承認して完了するまで待ちます。

brew install yrangana/tap/fm-mcp
fm-mcp install    # sets up Claude Code and Codex
fm-mcp doctor     # checks everything fm-mcp needs

その後、Claude Code または Codex の新しいセッションを開始します。fm-mcp は、ツールが初めて呼び出されたときにモデルサーバー（fm serve）を起動し、セッション終了時に停止します。

バイナリを入手するその他の方法：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/yrangana/fm-mcp/releases/latest/download/fm-mcp-installer.sh | sh
cargo install fm-mcp

fm-mcp install による変更内容

• Claude Code： ~/.claude.json に fm-mcp MCP サーバーを追加します（claude コマンドがある場合は claude mcp add を使用）。また、~/.claude/skills/ に fm-delegate スキルをインストールします。
• Codex： ~/.codex/config.toml に [mcp_servers.fm-mcp] を追加し、~/.codex/AGENTS.md（または使用している場合は AGENTS.override.md）にマーカー付きのセクションを追加します。

変更前に各ファイルをバックアップし、変更したすべてのパスを出力します。再度実行しても何も変更されません。--claude または --codex でエージェントを1つ選択でき、--dry-run で書き込みを行わずに変更内容を確認でき、--no-guidance でスキルと AGENTS.md セクションの追加を省略できます。fm-mcp install --uninstall を実行すると、追加したものをすべて削除します。

スキルと AGENTS.md セクションは、エージェントにいつ委任すべきかを伝えます。これらがない場合、エージェントが確認できるのはツールの説明だけで、委任の精度も低くなります。

別の方法：Claude Code プラグイン

このプラグインを使うと、fm-mcp install を使わずに Claude Code に MCP サーバーとスキルを追加できます。ただし、バイナリを PATH に含めておく必要があるため、先にインストールしてください（上記の Homebrew を参照）。インストールしていない場合、Claude Code はサーバーへの接続に失敗したと報告します。

/plugin marketplace add yrangana/fm-mcp
/plugin install fm-mcp@fm-mcp

Claude Code では、プラグインと fm-mcp install のどちらか一方を使い、両方は使わないでください。両方を使うと、Claude Code に fm-mcp サーバーが2つ登録されます。プラグインを使う場合は、fm-mcp install --codex を実行して Codex だけを設定してください。

その他の MCP クライアント

fm-mcp は標準入出力を使う通常の MCP サーバーなので、同じ Mac 上でローカルサーバーを実行する他のクライアントでも使用できます。fm-mcp install ではそれらの設定は行われず、委任のガイダンスも提供されません。エージェントはツールの説明だけをもとに判断します。以下の各クライアントは実際の Mac で試しました。それ以外のクライアントでも動作する可能性はありますが、未検証です。

Claude Desktop（2.31226.1、2026-10-11 で確認済み）。「Settings › Developer › Edit Config」で、claude_desktop_config.json の mcpServers に次の内容を追加し、Claude Desktop を終了して再起動します。

"fm-mcp": {
  "command": "/opt/homebrew/bin/fm-mcp",
  "args": []
}

フルパスを使用してください（which fm-mcp で確認できます）。fm-mcp は Mac 上のファイルで特に役立ちます。ファイルのパスを Claude に渡すと、Claude は path を渡すため、テキストが Claude を経由することはありません。Web ページの場合、Claude Desktop はまず自分でページを読み込むため、処理を委任しても何も節約できません。

Devin（旧 Windsurf）（Devin.app 3.8.20、2026-10-11 で確認済み）。~/.config/devin/mcp_config.json の mcpServers に次の内容を追加します。

"fm-mcp": {
  "type": "stdio",
  "command": "/opt/homebrew/bin/fm-mcp",
  "args": []
}

ツール

ツール	機能	処理できる量
summarise	ログ、ドキュメント、メモ、文字起こしを、段落または最大 7 個の箇条書きに要約します。完全な記録ではありません。	通常の文章なら約 30,000 語ですが、密度の高いログでは約 1,000 行までです。長い入力は分割して統合されるため、1～2 分かかることがあり、詳細が抜け落ちる場合があります。
extract	指定した JSON Schema に基づき、1 つのテキストから名前付きフィールドを JSON として抽出します。フラットなスキーマで最もよく機能します。	通常の文章なら約 3,500 語です。
classify	1 つのテキストを、指定したラベル（1 つ、または multi を使った複数のラベル）に分類します。	通常の文章なら約 3,500 語です。
ocr	PNG、JPEG、HEIC、TIFF、GIF、BMP 画像内のテキストを読み取ります。PDF には対応していません。	画像 1 枚です。

summarise、extract、classify は text、またはテキストファイルへの path（最大 1 MB）を受け取れるため、エージェントがファイル自体を読む必要はありません。docs/TOOLS.md に、すべてのパラメーターと呼び出し例が記載されています。

制限事項

• 小型モデル、短いコンテキスト： 約 8K トークンで、入力と回答で共有されます。ID や数値が多いログは、通常の文章より単語あたりのトークン数がはるかに多くなります。
• 次の用途には適しません： コード、数学、推論、テキストに含まれていない事実、または誤答のコストが高く、確認できない作業。
• 誤りが生じることがあります。 要約では詳細が抜け落ちたり、歪められたりする場合があります。extract はテキストにないフィールドに null を返すことがよくありますが、必ずそうなるとは限りません。短い請求書では、PO 番号がない場合に、25 回中 10 回、仕入先名がその値として返されました。モデルがフィールドの処理に行き詰まると、fm-mcp は完了済みのフィールドを保持し、行き詰まったフィールドを null に設定して、その旨を伝えます。この呼び出しには約 15 秒かかります。テキストに含まれている可能性が高いフィールドだけを指定してください。ネストしたスキーマは、フラットなスキーマより信頼性が低くなります。重要な内容は確認してください。
• 一度に 1 件のリクエストのみ。 モデルは Mac 上のすべてのセッションで共有されるため、呼び出しはキューに入ります。短い extract は 1～2 秒、長い summarise は 1 分以上かかります。
• 安全フィルター： デバイス上のモデルが、無害な入力を拒否する場合があります。fm-mcp はそのことを明確に報告し、エージェントが自分でタスクを実行します。

プライバシー

すべての処理は Mac 上で実行されます。fm-mcp はローカルの Unix ソケット経由で fm serve と通信し、ネットワーク経由では何も送信しません。テキストはデバイス上のモデルにのみ渡されます。SECURITY.md に詳細と、セキュリティ上の問題を非公開で報告する方法が記載されています。

トラブルシューティング

fm-mcp doctor を実行します。Mac、macOS、fm、ライセンス、モデル、テストリクエスト、両方のエージェントの設定を確認し、問題が見つかった場合は修正方法を示します。

問題	修正方法
ライセンスに同意していない	fm license を一度実行します。
モデルを利用できない	「システム設定」で Apple Intelligence を有効にし、モデルのダウンロードが完了するまで待ちます。
ツールに「処理が止まった」と表示される	通常、テキストに含まれていないフィールドを持つスキーマか、別のセッションがモデルを使用していることが原因です。よりフラットなスキーマを試してください。
長い入力でツールがタイムアウトする	制限を引き上げます。MCP サーバーの環境で FM_MCP_REQUEST_TIMEOUT_SECS（デフォルトは 120）を設定します。
さらに詳しい情報が必要	MCP サーバーの環境で FM_MCP_LOG=debug を設定します。fm-mcp は stderr にのみログを出力します（stdout は MCP プロトコルに使用されます）。

アンインストール

fm-mcp install --uninstall
brew uninstall fm-mcp

開発

git clone https://github.com/yrangana/fm-mcp.git
cd fm-mcp
cargo build --release
./target/release/fm-mcp install    # points your agents at this build

cargo test --features fake-fm      # needs no Apple Intelligence: uses a fake fm
cargo clippy --all-targets --all-features -- -D warnings
cargo fmt --check
scripts/real_fm_smoke.sh           # checks against the real fm on this Mac

AGENTS.md には、アーキテクチャ、fm serve についてテスト済みの事実、プロジェクトのルールが記載されています。docs/MANUAL_TEST.md は、各リリースで使用するチェックリストです。

ライセンス

MIT。fm-mcp は Apple とは提携しておらず、Apple の推奨も受けていません。Mac にインストールされた fm ツールを呼び出すもので、Apple のものは一切含まれていません。

ヤシル・ランガナ によって作成されました。