# fm-mcp

fm-mcp is an MCP server for Claude Code that hands text summaries, field extraction and classification to Apple’s on-device model. It can also read text from images.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: yrangana
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yrangana/fm-mcp
- Updated: 2026-10-18
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from github.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/fm-mcp

## What it does

fm-mcp sends summarisation, field extraction, classification and image OCR tasks to Apple’s local model. The agent can pass text or a file path; extracted fields come back as JSON shaped by a supplied schema. OCR handles one PNG, JPEG, HEIC, TIFF, GIF or BMP image, not PDFs.

It requires an Apple Silicon Mac, macOS 27 with Apple Intelligence enabled, and an accepted `fm` licence (`fm license`). The small model is not intended for code, maths or reasoning, and its output can omit or distort details. Input and output share a context of about 8K tokens. Requests queue when multiple sessions use the model on the same Mac.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- condense a log or transcript into a short summary
- extract named fields from text as schema-shaped JSON
- sort text into labels chosen for the task
- read text from a supported image

## Example prompts
- Summarise the log at `logs/app.log` in a few sentences.
- Extract the order number and date from this text as JSON.
- Read the text in `receipt.png`.

## Similar
- [image-to-text](https://affpapa.org/en/nevibecode/skills/image-to-text.md) — skill · 725 installs
- [PDF OCR Extraction](https://affpapa.org/en/nevibecode/skills/pdf-ocr-extraction.md) — skill · 6000 installs
- [vision-specialist](https://affpapa.org/en/nevibecode/plugins/vision-specialist.md) — plugin · ★ 2858 repo stars
- [SaSame Research](https://affpapa.org/en/nevibecode/mcp/sasame-research.md) — MCP server · 1865 installs
- [2s.io](https://affpapa.org/en/nevibecode/mcp/2sio.md) — MCP server · 928 installs
- [vision](https://affpapa.org/en/nevibecode/skills/vision.md) — skill · 16400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
