Y
yrangana/fm-mcp
★ 5·更新 2026-10-18
在 GitHub 查看 ↗直链 · 无中转页
我们没有可直接复制的安装命令,也没有公开的远端端点,所以不出配置。上面那条命令仅供参考,不是我们能担保的可复制命令——编一条出来比不给更糟。 各客户端的接法 →
- ★ 数取值
- 5 ★ · yrangana/fm-mcp · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 5 ★ · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
yrangana/fm-mcp;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# fm-mcp
以下摘录自该仓库的 README(片段)
An MCP server that lets coding agents such as Claude Code and Codex hand simple text work to the on-device model for Apple Foundation Models, the fm that ships with macOS 27. It's free, private, and runs offline.
mcp-name: io.github.yrangana/fm-mcp
Site: yrangana.github.io/fm-mcp, with what we learned building it: the measured limits of the on-device model.
Created by Yasiru Rangana, AI Architect and AI Engineer, Sydney.
## Why
Coding agents spend paid, remote tokens on simple jobs, like summarising a log or pulling fields out of a document. A small model already on your Mac can do much of that for nothing, and your text never leaves the machine. fm-mcp lets the agent hand off that work, and tells it plainly what the small model can't do.
## Install
fm-mcp is a public beta (0.1.x): it works and is tested, but tool details may change between releases. CHANGELOG.md lists what changed.
You need a Mac with Apple Silicon (Intel Macs are not supported), macOS 27 with Apple Intelligence turned on, and the fm licence accepted once (fm license). That's the whole support policy: fm-mcp doctor checks each of these, and nothing else is supported.
No Homebrew yet? Install it from brew.sh first. Its installer asks to install Xcode's command line tools: accept, and let it finish.
sh
brew install yrangana/tap/fm-mcp
fm-mcp install # sets up Claude Code and Codex
fm-mcp doctor # checks everything fm-mcp needs
Then start a new Claude Code or Codex session. fm-mcp starts the model server (fm serve) itself the first time a tool is called, and stops it when the session ends.
Other ways to get the binary:
sh
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/yrangana/fm-mcp/releases/latest/download/fm-mcp-installer.sh | sh
cargo install fm-mcp
### What fm-mcp install changes
Claude Code: adds the fm-mcp MCP server to ~/.claude.json (through claude mcp add when the claude command is there), and installs the fm-delegate skill in ~/.claude/skills/.
Codex: adds [mcp_servers.fm-mcp] to ~/.codex/config.toml, and a marked section in ~/.codex/AGENTS.md (or in AGENTS.override.md, if you use one).
It backs up each file before changing it and prints every path it touched; running it again changes nothing. --claude or --codex picks one agent, --dry-run shows the changes without writing, and --no-guidance skips the skill and the AGENTS.md section. fm-mcp install --uninstall removes everything it added.
The skill and the AGENTS.md section tell the agent when to delegate. Without them the agent sees only the tool descriptions, and delegates less well.
### Or: the Claude Code plugin
The plugin gives Claude Code the MCP server and the skill, without fm-mcp install. It still needs the binary on your PATH, so install that first (Homebrew above); otherwise Claude Code reports the server as failed to connect.
/plugin marketplace add yrangana/fm-mcp
/plugin install fm-mcp@fm-mcp
Use the plugin or fm-mcp install for Claude Code, not both: both together give Claude Code two fm-mcp servers. With the plugin, run fm-mcp install --codex to set up Codex only.
### Other MCP clients
fm-mcp is a plain stdio MCP server, so other clients that run local servers on the same Mac can use it. fm-mcp install doesn't set them up, and they don't get the delegation guidance: the agent decides from the tool descriptions alone. Each client below was tried on a real Mac; others may work but are untested.
mcp-name: io.github.yrangana/fm-mcp
Site: yrangana.github.io/fm-mcp, with what we learned building it: the measured limits of the on-device model.
Created by Yasiru Rangana, AI Architect and AI Engineer, Sydney.
## Why
Coding agents spend paid, remote tokens on simple jobs, like summarising a log or pulling fields out of a document. A small model already on your Mac can do much of that for nothing, and your text never leaves the machine. fm-mcp lets the agent hand off that work, and tells it plainly what the small model can't do.
## Install
fm-mcp is a public beta (0.1.x): it works and is tested, but tool details may change between releases. CHANGELOG.md lists what changed.
You need a Mac with Apple Silicon (Intel Macs are not supported), macOS 27 with Apple Intelligence turned on, and the fm licence accepted once (fm license). That's the whole support policy: fm-mcp doctor checks each of these, and nothing else is supported.
No Homebrew yet? Install it from brew.sh first. Its installer asks to install Xcode's command line tools: accept, and let it finish.
sh
brew install yrangana/tap/fm-mcp
fm-mcp install # sets up Claude Code and Codex
fm-mcp doctor # checks everything fm-mcp needs
Then start a new Claude Code or Codex session. fm-mcp starts the model server (fm serve) itself the first time a tool is called, and stops it when the session ends.
Other ways to get the binary:
sh
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/yrangana/fm-mcp/releases/latest/download/fm-mcp-installer.sh | sh
cargo install fm-mcp
### What fm-mcp install changes
Claude Code: adds the fm-mcp MCP server to ~/.claude.json (through claude mcp add when the claude command is there), and installs the fm-delegate skill in ~/.claude/skills/.
Codex: adds [mcp_servers.fm-mcp] to ~/.codex/config.toml, and a marked section in ~/.codex/AGENTS.md (or in AGENTS.override.md, if you use one).
It backs up each file before changing it and prints every path it touched; running it again changes nothing. --claude or --codex picks one agent, --dry-run shows the changes without writing, and --no-guidance skips the skill and the AGENTS.md section. fm-mcp install --uninstall removes everything it added.
The skill and the AGENTS.md section tell the agent when to delegate. Without them the agent sees only the tool descriptions, and delegates less well.
### Or: the Claude Code plugin
The plugin gives Claude Code the MCP server and the skill, without fm-mcp install. It still needs the binary on your PATH, so install that first (Homebrew above); otherwise Claude Code reports the server as failed to connect.
/plugin marketplace add yrangana/fm-mcp
/plugin install fm-mcp@fm-mcp
Use the plugin or fm-mcp install for Claude Code, not both: both together give Claude Code two fm-mcp servers. With the plugin, run fm-mcp install --codex to set up Codex only.
### Other MCP clients
fm-mcp is a plain stdio MCP server, so other clients that run local servers on the same Mac can use it. fm-mcp install doesn't set them up, and they don't get the delegation guidance: the agent decides from the tool descriptions alone. Each client below was tried on a real Mac; others may work but are untested.
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/yrangana-fm-mcp/)
- 来源
- awesome · https://github.com/yrangana/fm-mcp
- 按领域浏览
- MCP 服务
- Traction
- 5 ★
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。