midos-mcp
MidOS MCP Community Library — Knowledge, Skills, and Research as MCP tools.
Install once, connect to any AI client.
Install
pip install midos-mcp
Requirement: MidOS knowledge base must be available locally. Set the MIDOS_ROOT environment variable to point to your MidOS installation directory (the one containing knowledge/ and modules/).
export MIDOS_ROOT=/path/to/midos
Quick Start
# Start server (stdio — default for Claude Code, Cursor, etc.)
midos-mcp serve
# Start with HTTP transport
midos-mcp serve --http
# Generate config for your AI client
midos-mcp config --generate claude
midos-mcp config --generate cursor
# Check health
midos-mcp health
Commands
midos-mcp serve
Start the MCP server with your preferred transport.
midos-mcp serve # stdio (default)
midos-mcp serve --http # Streamable HTTP on 127.0.0.1:8419
midos-mcp serve --sse # Legacy SSE transport
midos-mcp serve --http --host 0.0.0.0 --port 9000
midos-mcp config
Generate ready-to-paste JSON config for any supported MCP client.
midos-mcp config --generate claude # Claude Desktop / Claude Code
midos-mcp config --generate cursor # Cursor IDE
midos-mcp config --generate cline # Cline (VS Code)
midos-mcp config --generate windsurf # Windsurf IDE
midos-mcp config --generate continue # Continue.dev
midos-mcp config --generate zed # Zed Editor
midos-mcp config --generate opencode # OpenCode
midos-mcp config --generate http # Generic HTTP client
# Write to file
midos-mcp config --generate claude -o mcp-config.json
midos-mcp health
Check server health: knowledge base stats, vector store status, dependencies.
midos-mcp health # Human-readable output
midos-mcp health --json # JSON output for scripts
midos-mcp keys
Manage API keys for tiered access control.
midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc
Tiers: dev (free), pro ($10/mo), admin.
Configuration
Environment Variables
Root Detection
The server locates the MidOS knowledge base:
MIDOS_ROOTenvironment variable (recommended)- Auto-detect: walks up from package location looking for
CLAUDE.md+knowledge/ - Fallback: current working directory
If you installed via pip, auto-detect won't find the knowledge base. Either:
# Option A: Clone the repo and point to it
git clone https://github.com/MidOSresearch/midos.git
export MIDOS_ROOT=./midos
# Option B: Point to an existing MidOS directory
export MIDOS_ROOT=/path/to/your/midos
Verify with midos-mcp health — it shows the detected root and knowledge counts.
Supported Clients
Optional Dependencies
# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]
# Development tools
pip install midos-mcp[dev]
What's Inside
MidOS exposes 68 MCP tools across 2 tiers:
Capabilities
- Knowledge — Search 46K+ curated chunks across all domains (full content, no truncation)
- Skills — 119 reusable patterns across 16+ technology stacks
- EUREKA — 383 validated improvements with measured ROI
- Truth — 50 verified patches and corrections
- SOTA — 140 state-of-the-art convergence ceilings
- Vector Search — Semantic search via LanceDB + Gemini embeddings (3072-d)
Rate Limits
Invalid or expired API keys silently fall back to Dev tier.
Requirements
- Python 3.10+
- FastMCP 2.x
- MidOS knowledge base (local)
License
MIT