M1K3

MCP文档知识

提供方 未标注

文档知识 未标注 未标注 官方维护 ClaudeCursorVS CodeGemini CLI

私有记忆、文档、语音以及本地LLM,供您的编码代理使用,由M1K3 Mac应用在设备端提供服务。通过受令牌保护的环回HTTP服务器提供18个工具。源代码可用。

一句话选型结论

按资料字段整理

M1K3 属于文档知识类 MCP 服务器,传输方式未标注,鉴权方式未标注,可直接接入 Claude、Cursor、VS Code 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权未标注 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 官方维护 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

记忆

安装与配置

未标注 未标注
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
M1K3当前 未标注 未标注 未标注 无 未标注
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式未标注远程服务建议用最小权限凭据
维护方官方维护核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

11.6 KB
来自项目仓库与上游目录的原文,未做删改

Your AI. Your devices. Private by design.

Local AI that runs entirely on your Apple-Silicon Mac —
on-device LLM inference, live voice, a personal knowledge graph with RAG,
encrypted call transcription, a local agent, and an MCP server.

No telemetry. Every network call shows itself and can be switched off.

Download the DMG
· m1k3.app
· TestFlight beta
· Connect a coding agent

macOS 26 Tahoe or later · Apple Silicon · signed & notarized (Developer ID)


What's inside

  • On-device inference — three brains: Apple Foundation Models for instant
    answers, Qwen 3 4B, and Gemma 4 12B via MLX. Chat with Mini from the first
    second while a bigger brain downloads.
  • Live voice — sentence-streamed neural TTS + on-device speech-to-text, and
    a full-window voice mode with karaoke captions.
  • Knowledge + RAG — drop in notes and PDFs; M1K3 remembers and cites, locally.
  • A memory that repairs itself — a temporal memory graph of dated facts;
    when you correct something, the dream cycle supersedes the stale fact instead
    of silently losing either version, and keeps the history visible.
  • A face, and creatures — the Phosphor Fox by default (a white wireframe
    lattice), with the pixel face and a cast of low-poly 3D companions to
    choose from, all rendered on-device with RealityKit.
  • Call memory — encrypted, on-device call transcription.
  • A local agent — tools that do things, grounded in your own data, with
    markdown + syntax-highlighted code in chat.
  • MCP server — 18 tools over local HTTP; give Claude and other agents a
    resident with a voice, a memory, and your knowledge.

Everything above runs on the device. M1K3 uses the network for two things: the
one-time download of a bigger brain when you ask for one, and web search, which
is on by default so answers can be current, with one switch in Settings to turn
it off. The Mac App Store build also carries an opt-in Private Cloud Compute
brain — off by default, picked by you, consent asked once, every PCC answer
labelled. The Developer ID DMG has no cloud path at all — see
SECURITY.md. One more path is yours rather than M1K3's: a
thumbs-down on an answer in the Mac app can offer to email that one exchange to
Round Tower — the exact text is shown and editable first, your own mail app
sends it, and nothing goes without you pressing Send.

Surface Where Stack Status
macOS native macos/ Swift 6.2, SwiftUI, MLX-Swift The product — on-device knowledge · RAG · agent · voice · calls. Build it: macos/README.md.
iOS + visionOS macos/M1K3iOSApp/ Swift 6.2, SwiftUI Native SwiftUI shell on the same macos/Sources/ package graph — chat · RAG · memories · docs. Ladder tops out at Lil on-device. See macos/docs/IOS_VISIONOS_PORT.md.
間 AI mobile app/ Kotlin Multiplatform Slow burn — the Android surface (KMP), pre-release. See app/README.md.
The attic git history before 7545b4a4 Python, THREE.js, Tauri Where M1K3 grew up — the original CLI, avatar experiments, and ideas. Cleared from the tree 2026-08-13; see The attic.

Get M1K3

  • Mac App Store — the easiest way in; it updates through the store.
  • Homebrew — brew trust round-tower/tap && brew install --cask round-tower/tap/m1k3 (also puts m1k3 on your PATH).
  • Download the DMG — signed & notarized.
  • Build from source — macos/README.md: clone → xcodegen generate → ⌘R.
  • iPhone & iPad on the App Store — the same purchase as the Mac app; the ladder tops out at Lil on-device. The TestFlight beta gets builds first.

Agents

M1K3 ships a command-line client, m1k3, inside the app bundle. It's a thin
client — the running app is the daemon (one MLX slot on the machine, and it
belongs to M1K3.app).```sh
brew trust round-tower/tap # Homebrew 6: trust the tap once
brew install --cask round-tower/tap/m1k3 # the cask symlinks Contents/Helpers/m1k3

Open M1K3 ▸ Settings ▸ MCP Server: switch it on, then Copy the token

m1k3 login # paste the token (echo off; kept in your keychain)
m1k3 connect claude # also: codex · cursor · vscode · zed


The MCP server is off until you switch it on, and every request carries its
access token: `m1k3 login` stores it, and `connect` writes it into your agent's
config as an `Authorization: Bearer` header. Without it the server answers 401.

Then `m1k3 status`, `m1k3 ask "what did I decide about the pin?"`,
`m1k3 remember "…"`, `m1k3 search "…"`, `m1k3 speak "build's green"`.

Prefer clicking? **M1K3 ▸ Settings ▸ MCP Server** has the same thing:
pick your agent, copy the snippet (the token is already in it). Already have M1K3 installed? The binary is
at `/Applications/M1K3.app/Contents/Helpers/m1k3`.

### Tell your agents about the resident

`m1k3 agent-notes --write` folds this into a project's `AGENTS.md` (or any path
you name). It's marker-fenced, so re-running it replaces the block rather than
stacking copies:```markdown

## M1K3 is the resident

M1K3 is a local, private assistant running on this Mac, reachable over MCP. It
holds the user's own documents and memories — so before you search the web, ask
it: `ask_m1k3` for a grounded answer, `search_knowledge` for the sources behind
one. Persist a durable fact with `remember` and it is there next session too.
`speak` narrates aloud, which is often kinder than a wall of text.

M1K3 can be down — a "disconnected" MCP server just means the app is closed.
Never block on it; carry on without it.

One honest caveat: the App Store build's helper is sandboxed, so it
can't write another app's config file or run claude for you. There, m1k3 connect prints the config to paste instead — and says so. The Developer ID
build (the DMG and the Homebrew cask) does the write.

MCP integration

The running Mac app serves MCP over HTTP at http://127.0.0.1:4242/mcp —
knowledge search, documents, voice, and ask_m1k3 (ask the resident AI).
Every request carries the server's access token (Settings ▸ MCP Server);
m1k3 login && m1k3 connect claude wires Claude Code in. Setup for any
client: macos/docs/MCP_SETUP.md.

Tools

18 tools (generated live from the running server).

Tool Required args What it does
ask_m1k3 — Ask M1K3's local brain a question
forget_memory query Permanently forget a fact M1K3 remembers — the consent primitive, the counterpart to remember
get_answer job_id Fetch the result of an ask_m1k3 call that returned a job id because it was taking a while
get_document id Fetch the text of one indexed item by its id (from list_documents)
get_status — M1K3's overall status: active brain tier, TTS provider, voice tier, and the busy flags — whether M1K3 is speaking, in a conversation, using its mic, or already answering an ask_m1k3 call
list_documents — List the items M1K3 has indexed, with their ids, kinds, and titles.
list_jobs — List recent ask_m1k3 jobs — id, state (running/done/error), and age in seconds
list_todos — The user's todo list as M1K3 holds it
listen — Listen on M1K3's microphone and return the transcript once the speaker pauses (or the timeout passes)
memory_stats — How many atomic facts M1K3 currently remembers (the live, non-superseded count)
open_link url Open a web link in M1K3's review panel on the user's screen, beside the conversation, so they can see the page
propose_todo title PROPOSE a todo for the user
recall_memory query Recall atomic facts M1K3 remembers about the user — the temporal memory GRAPH, separate from the document corpus search_knowledge reads
related_memory query Recall the single best matching fact for the query, then walk M1K3's memory GRAPH one step out to its neighbours (linked or superseded facts)
remember title, text Store text in M1K3's memory — it becomes part of what M1K3 knows, searchable in every future conversation (the same store search_knowledge reads)
search_knowledge query Search M1K3's stored knowledge (documents, calls, notes; hybrid retrieval when available)
speak text Speak text aloud through M1K3's voice (and animate the avatar)
stop_speaking — Stop any in-progress speech immediately.

> The table above is generated live from the running app — never hand-edit it.
> Refresh with mcp-inventory --inject README.md --server m1k3 (needs the M1K3 app running).

The attic

M1K3 didn't start as a Mac app. It started in August 2025 as a Python CLI with
a synthesized voice, grew a THREE.js avatar, a PWA, a Tauri popover, a RAG
engine, and an MCP server — and then everything it learned was rebuilt native.
That history is signed and permanent in this repo's git history — a project
about provenance should keep its own. The attic/ tree was cleared from the
working copy on 2026-08-13; to walk through it, check out any commit before
7545b4a4 (or resurrect it with git checkout 7545b4a4 -- attic).

Contributing

Start with CONTRIBUTING.md. Architecture and current
state: CLAUDE.md. Security reports: SECURITY.md.

The quickest way to help: if M1K3 earns a place on your Mac, star the repo
(it's how other people find it), and open an issue when something breaks.

Privacy

Inference, retrieval, and voice run on-device; M1K3 itself has no servers and
never sees or stores your conversations. Two things can leave the machine, each
a switch: web search and the lookups it makes (on by default) and, in the Mac App Store build only, the
opt-in Private Cloud Compute brain (off by default) — when you pick it, your
message goes to Apple's Private Cloud Compute, and the conversation so far only
if you tick it. See SECURITY.md for what is and is not sent
and Apple's own guarantees, quoted and linked.

License

Functional Source License, FSL-1.1-ALv2. M1K3 is
source-available and free for humans, forever: read every line, build it,
modify it, run it for yourself, use it inside your organisation, teach with
it, research with it. What the licence does not permit is a competing use —
offering M1K3, a fork of it, or a substantially similar product to others as a
commercial product or service. Each version converts to Apache-2.0 two years
after release. It is not an OSI open-source licence and we don't call it one.
Attribution and third-party notices are in NOTICE; the decision
and its reasons are in
ADR 0005.

Revisions before 2026-09-09 were published under Apache-2.0 and stay that way;
the boundary is recorded in NOTICE.

The source is public; the name is not. M1K3, the M mark, the pixel face
and CRT look, the icon, and the voice are trademarks and brand assets, all
rights reserved and outside the licence grant. See
TRADEMARKS.md. The companion creatures are not ours: the
Fox is the Khronos glTF sample by PixelMannen (CC0) and tomkranis (CC-BY 4.0);
Colobus, Gecko, Inkfish and Sparrow are by Quaternius
(CC0) — credited in NOTICE and in the app's Third-party licenses screen. The only official builds are Round Tower's
(app.m1k3 on the App Store and TestFlight, and the DMGs on m1k3.app).

Organisations: M1K3 for Teams — the same on-device brains, institutional
memory, and a tuned persona served on your own Apple Silicon hardware, under
your own domain — is licensed separately.
See m1k3.app/teams or write to hello@round-tower.ie.

Contributions are by invitation under a short CLA (Apache-2.0
inbound, FSL outbound). M1K3 is built in the open with
MurphySig provenance — the git history is signed,
human-and-AI collaboration on the record.

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
M1K3 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

M1K3 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

M1K3 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

M1K3 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

M1K3 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code、Gemini CLI、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

M1K3 能提供哪些能力?

资料显示能力标签包括 记忆。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。