M1K3 — MCP server for Claude Code: memory, docs and voice
A local MCP server served by a Mac app: knowledge search, documents, voice and a query tool for the resident AI. Useful when an agent needs your data without the cloud.
Open on GitHubWhat M1K3 does
M1K3 is a SwiftUI app for macOS that exposes an MCP server over HTTP at http://127.0.0.1:4242/mcp. Agents calling it get knowledge search backed by RAG, document access, voice features and ask_m1k3, which asks the AI living inside the app. Wiring it into Claude or another MCP client is covered in docs/MCP_SETUP.md.
You build it from source. That takes macOS 26 (Tahoe) on Apple Silicon, Xcode 26.x with the Swift 6.2 toolchain, and XcodeGen. Clone the repo, go to m1k3/macos, run xcodegen generate, then open M1K3.xcodeproj. The project.yml file is the source of truth; the .xcodeproj itself is generated and not tracked.
Compiling with CODE_SIGNING_ALLOWED=NO works, but the app then runs outside its sandbox container and reads and writes the wrong data locations. Sign with your own development team instead. Models download once from Hugging Face; after that only web search touches the network, and it is on by default with a single switch in Settings to turn it off.
What it helps with
- hand an agent access to a personal knowledge base over HTTP
- search documents through RAG from an MCP client
- ask the resident AI a question with
ask_m1k3 - wire speech input and synthesis into an agent
- build a Mac app from source with XcodeGen
Example prompts for the agent
- Connect the M1K3 MCP server at
http://127.0.0.1:4242/mcpand search my documents for release notes - Ask
ask_m1k3what my knowledge base says about the project architecture - List the tools the M1K3 MCP server exposes
How to install M1K3
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about M1K3
How do I install M1K3 in Claude Code?
There is no install command — the app is built from source. Clone the repository, change into m1k3/macos, run xcodegen generate, open M1K3.xcodeproj and build. Then point your client at http://127.0.0.1:4242/mcp following docs/MCP_SETUP.md.
What does M1K3 do?
It is a Mac app that serves a local MCP server, giving agents knowledge search, document access, voice and the ask_m1k3 tool for querying the built-in AI.
What are the requirements for M1K3?
macOS 26 (Tahoe) on Apple Silicon, Xcode 26.x with Swift 6.2, and XcodeGen. Without signing with your own development team the app runs without its sandbox container and uses the wrong data paths.
