MidOS - MCP Community Library MCP Server
io.github.MidOSresearch/midos-mcp
Curated knowledge API for AI agents—skill packs, semantic search, and validated patterns.
What is the MidOS - MCP Community Library MCP server?
The MidOS MCP Community Library is a knowledge and skills API that exposes 68 MCP tools for semantic search, reusable patterns, and validated improvements across 46K+ curated chunks. It integrates with Claude, Cursor, Cline, and other AI clients via stdio or HTTP transport, requiring a local MidOS knowledge base installation.
MidOS provides AI agents with access to a curated knowledge base of 46K+ chunks, 119 reusable skill patterns, 383 validated improvements (EUREKA), and semantic vector search. Use it to augment Claude or Cursor with domain-specific knowledge, retrieve best practices, and access state-of-the-art convergence ceilings—all locally or via HTTP.
How to install MidOS - MCP Community Library
Copy-paste configuration for popular MCP clients.
Tools & capabilities
Tools this server exposes to the agent.
Knowledge Search— Search 46K+ curated chunks across all domains with full content (no truncation)Skills— Access 119 reusable patterns across 16+ technology stacksEUREKA— Retrieve 383 validated improvements with measured ROITruth— Access 50 verified patches and correctionsSOTA— Query 140 state-of-the-art convergence ceilingsVector Search— Semantic search via LanceDB + Gemini embeddings (3072-d)API Key Management— Generate and manage tiered API keys (dev, pro, admin)Health Check— Monitor knowledge base stats, vector store status, and dependencies
Use cases
- Search a curated knowledge base of 46K+ chunks to augment Claude or Cursor with domain-specific information
- Retrieve 119 reusable skill patterns and best practices across 16+ technology stacks
- Access 383 validated improvements (EUREKA) with measured ROI for optimization decisions
- Perform semantic search on knowledge using vector embeddings for more relevant results
- Verify patches and corrections from the Truth database for security and accuracy
- Query state-of-the-art convergence ceilings to understand performance limits in your domain
MidOS - MCP Community Library MCP server FAQ
MidOS is a knowledge and skills API that exposes 68 MCP tools for semantic search, reusable patterns, and validated improvements. It integrates with AI clients like Claude, Cursor, and Cline to augment them with curated domain knowledge.
Yes, the Dev tier is free and includes 34 tools, 500 queries/month, and full content access. A Pro tier ($10/mo) offers 68 tools, 100,000 queries/month, and additional security ops and orchestration packs.
Install via pip (pip install midos-mcp), set MIDOS_ROOT to your MidOS directory, then run midos-mcp config --generate cursor or midos-mcp config --generate claude to get ready-to-paste JSON config.
MidOS supports stdio (default for Claude Code, Cursor, Cline), Streamable HTTP (127.0.0.1:8419), and legacy SSE. Use midos-mcp serve --http for remote access.
No API key is required for the free Dev tier. API keys are optional and used to unlock Pro tier features; invalid or expired keys silently fall back to Dev tier.
The MidOS knowledge base is a local directory containing 46K+ curated chunks, 119 skill patterns, 383 validated improvements, and 140 state-of-the-art references. It must be cloned from the GitHub repo and pointed to via MIDOS_ROOT.
README (reference)
Source of truth, from the repository.
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
| Flag | Transport | Use Case |
|---|---|---|
--stdio | stdio | Claude Code, Cursor, Cline (default) |
--http | Streamable HTTP | Web clients, remote access |
--sse | Server-Sent Events | Legacy clients |
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
| Variable | Default | Description |
|---|---|---|
MIDOS_ROOT | auto-detect | Path to MidOS installation (required) |
MIDOS_HOST | 127.0.0.1 | HTTP server bind host |
MIDOS_PORT | 8419 | HTTP server bind port |
MIDOS_TRANSPORT | stdio | Default transport |
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
| Client | Config File | Transport |
|---|---|---|
| Claude Desktop | claude_desktop_config.json | stdio |
| Claude Code | .mcp.json | stdio |
| Cursor | .cursor/mcp.json | stdio |
| Cline | cline_mcp_settings.json | stdio |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | stdio |
| Continue.dev | ~/.continue/config.json | stdio |
| Zed | ~/.config/zed/settings.json | stdio |
| OpenCode | opencode.json | SSE |
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:
| Tier | Tools | Access |
|---|---|---|
| Dev | 34 tools | Free — no API key needed, full content, 500 queries/month |
| Pro | 68 tools | $10/mo — security ops, AOTC, orchestration, maker write ops |
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
| Tier | Queries/month | Content |
|---|---|---|
| Dev | 500 | Full content (no truncation) |
| Pro | 100,000 | Full content + AOTC + ops packs |
Invalid or expired API keys silently fall back to Dev tier.
Requirements
- Python 3.10+
- FastMCP 2.x
- MidOS knowledge base (local)
License
MIT
Related MCP servers

MidOS - MCP Community Library
Curated knowledge base for AI agents — 19K chunks, 121 skills, semantic search via MCP

Memory Vault
Self-hosted AI memory layer with hybrid search, knowledge graphs, and MCP integration for Claude.
Generate design token systems from a hex color — OKLCH-derived, WCAG-validated, multi-format
View repository →
ANIME INTELLIGENCE
Anime shopping intelligence: identity, value, authenticity, BUY/WAIT and purchase routing via x402.

Meta Ads MCP by ScaleForge — control Facebook & Instagram Ads via Graph API v24.0. 32 tools.
Live tools for USDi: CPI-indexed exchange rate, contract/pool addresses, and mint/redeem mechanics.

