midos

# midos-mcp

**MidOS MCP Community Library** — Knowledge, Skills, and Research as MCP tools.

Install once, connect to any AI client.

## Install

```bash
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/`).

```bash
export MIDOS_ROOT=/path/to/midos
```

## Quick Start

```bash
# 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 cursor
midos-mcp config --generate cursor

# Check health
midos-mcp health
```

## Commands

### `midos-mcp serve`

Start the MCP server with your preferred transport.

```bash
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.

```bash
midos-mcp config --generate cursor    # 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 cursor -o mcp-config.json
```

### `midos-mcp health`

Check server health: knowledge base stats, vector store status, dependenci