Skip to main content
Glama
deenesjakoruzh
MidOSresearch

MidOS Research Protocol

by MidOSresearch
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

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

Related MCP server: Code-MCP

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:

  1. MIDOS_ROOT environment variable (recommended)

  2. Auto-detect: walks up from package location looking for CLAUDE.md + knowledge/

  3. 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

Install Server
A
license - permissive license
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
61dResponse time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Tools

View all tools

Related MCP Servers

  • Stacks Clarity MCP Server

    exponentlabshq
    F
    license
    B
    quality
    D
    maintenance
    Enables comprehensive Stacks blockchain development with 30+ specialized tools for Clarity smart contracts, SIP compliance, security analysis, and performance optimization. Provides complete access to SIP standards, token development templates, security-first patterns with mandatory post-conditions, and full-stack dApp development guidance.
    Last updated
    36
    7

  • Code-MCP

    millsydotdev
    F
    license
    B
    quality
    -
    maintenance
    Turns AI assistants into full-stack software engineers with 36 tools for cognitive reasoning, code validation, project scaffolding, and AI/IDE configuration generation across 130+ programming languages, databases, and frameworks.
    Last updated
    35
    45

  • Skills MCP Server

    Blindex09
    F
    license
    -
    quality
    D
    maintenance
    Exposes 1,334 skills as global MCP tools across Claude Desktop, VSCode, and Cursor, automatically discovering and categorizing skills from a local directory into 18 categories with semantic search capabilities.
    Last updated

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MidOSresearch/midos'

If you have feedback or need assistance with the MCP directory API, please join our Discord server