{
  "markdown": "# midos-mcp\n\n**MidOS MCP Community Library** — Knowledge, Skills, and Research as MCP tools.\n\nInstall once, connect to any AI client.\n\n## Install\n\n```bash\npip install midos-mcp\n```\n\n**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/`).\n\n```bash\nexport MIDOS_ROOT=/path/to/midos\n```\n\n## Quick Start\n\n```bash\n# Start server (stdio — default for Claude Code, Cursor, etc.)\nmidos-mcp serve\n\n# Start with HTTP transport\nmidos-mcp serve --http\n\n# Generate config for your AI client\nmidos-mcp config --generate claude\nmidos-mcp config --generate cursor\n\n# Check health\nmidos-mcp health\n```\n\n## Commands\n\n### `midos-mcp serve`\n\nStart the MCP server with your preferred transport.\n\n```bash\nmidos-mcp serve              # stdio (default)\nmidos-mcp serve --http       # Streamable HTTP on 127.0.0.1:8419\nmidos-mcp serve --sse        # Legacy SSE transport\nmidos-mcp serve --http --host 0.0.0.0 --port 9000\n```\n\n| Flag | Transport | Use Case |\n|------|-----------|----------|\n| `--stdio` | stdio | Claude Code, Cursor, Cline (default) |\n| `--http` | Streamable HTTP | Web clients, remote access |\n| `--sse` | Server-Sent Events | Legacy clients |\n\n### `midos-mcp config`\n\nGenerate ready-to-paste JSON config for any supported MCP client.\n\n```bash\nmidos-mcp config --generate claude    # Claude Desktop / Claude Code\nmidos-mcp config --generate cursor    # Cursor IDE\nmidos-mcp config --generate cline     # Cline (VS Code)\nmidos-mcp config --generate windsurf  # Windsurf IDE\nmidos-mcp config --generate continue  # Continue.dev\nmidos-mcp config --generate zed       # Zed Editor\nmidos-mcp config --generate opencode  # OpenCode\nmidos-mcp config --generate http      # Generic HTTP client\n\n# Write to file\nmidos-mcp config --generate claude -o mcp-config.json\n```\n\n### `midos-mcp health`\n\nCheck server health: knowledge base stats, vector store status, dependencies.\n\n```bash\nmidos-mcp health          # Human-readable output\nmidos-mcp health --json   # JSON output for scripts\n```\n\n### `midos-mcp keys`\n\nManage API keys for tiered access control.\n\n```bash\nmidos-mcp keys generate --name \"my-app\" --tier dev\nmidos-mcp keys list\nmidos-mcp keys revoke midos_sk_abc\n```\n\nTiers: `dev` (free), `pro` ($10/mo), `admin`.\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `MIDOS_ROOT` | auto-detect | Path to MidOS installation (required) |\n| `MIDOS_HOST` | `127.0.0.1` | HTTP server bind host |\n| `MIDOS_PORT` | `8419` | HTTP server bind port |\n| `MIDOS_TRANSPORT` | `stdio` | Default transport |\n\n### Root Detection\n\nThe server locates the MidOS knowledge base:\n\n1. `MIDOS_ROOT` environment variable (recommended)\n2. Auto-detect: walks up from package location looking for `CLAUDE.md` + `knowledge/`\n3. Fallback: current working directory\n\n**If you installed via pip**, auto-detect won't find the knowledge base. Either:\n\n```bash\n# Option A: Clone the repo and point to it\ngit clone https://github.com/MidOSresearch/midos.git\nexport MIDOS_ROOT=./midos\n\n# Option B: Point to an existing MidOS directory\nexport MIDOS_ROOT=/path/to/your/midos\n```\n\nVerify with `midos-mcp health` — it shows the detected root and knowledge counts.\n\n## Supported Clients\n\n| Client | Config File | Transport |\n|--------|-------------|-----------|\n| Claude Desktop | `claude_desktop_config.json` | stdio |\n| Claude Code | `.mcp.json` | stdio |\n| Cursor | `.cursor/mcp.json` | stdio |\n| Cline | `cline_mcp_settings.json` | stdio |\n| Windsurf | `~/.codeium/windsurf/mcp_config.json` | stdio |\n| Continue.dev | `~/.continue/config.json` | stdio |\n| Zed | `~/.config/zed/settings.json` | stdio |\n| OpenCode | `opencode.json` | SSE |\n\n## Optional Dependencies\n\n```bash\n# Vector store support (LanceDB + embeddings)\npip install midos-mcp[vector]\n\n# Development tools\npip install midos-mcp[dev]\n```\n\n## What's Inside\n\nMidOS exposes 68 MCP tools across 2 tiers:\n\n| Tier | Tools | Access |\n|------|-------|--------|\n| **Dev** | 34 tools | Free — no API key needed, full content, 500 queries/month |\n| **Pro** | 68 tools | $10/mo — security ops, AOTC, orchestration, maker write ops |\n\n### Capabilities\n\n- **Knowledge** — Search 46K+ curated chunks across all domains (full content, no truncation)\n- **Skills** — 119 reusable patterns across 16+ technology stacks\n- **EUREKA** — 383 validated improvements with measured ROI\n- **Truth** — 50 verified patches and corrections\n- **SOTA** — 140 state-of-the-art convergence ceilings\n- **Vector Search** — Semantic search via LanceDB + Gemini embeddings (3072-d)\n\n## Rate Limits\n\n| Tier | Queries/month | Content |\n|------|:-------------:|---------|\n| Dev | 500 | Full content (no truncation) |\n| Pro | 100,000 | Full content + AOTC + ops packs |\n\nInvalid or expired API keys silently fall back to Dev tier.\n\n## Requirements\n\n- Python 3.10+\n- FastMCP 2.x\n- MidOS knowledge base (local)\n\n## License\n\nMIT\n",
  "bytes": 5017,
  "sha": "ebce75a2ac9d0caaf28dcc25247f677d6904981f73c0c569435dab628675bf78",
  "repo_slug": "midosresearch/midos-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_midosresearch_midos_mcp_ddfb587d/readme"
}