MidOS Research Protocol
midos-mcp
MidOS MCP 커뮤니티 라이브러리 — MCP 도구로서의 지식, 기술 및 연구.
한 번 설치하면 모든 AI 클라이언트에 연결할 수 있습니다.
설치
pip install midos-mcp요구 사항: MidOS 지식 베이스를 로컬에서 사용할 수 있어야 합니다. MIDOS_ROOT 환경 변수를 설정하여 MidOS 설치 디렉토리(knowledge/ 및 modules/를 포함하는 디렉토리)를 가리키도록 하십시오.
export MIDOS_ROOT=/path/to/midosRelated MCP server: Code-MCP
빠른 시작
# 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명령어
midos-mcp serve
선호하는 전송 방식으로 MCP 서버를 시작합니다.
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플래그 | 전송 방식 | 사용 사례 |
| stdio | Claude Code, Cursor, Cline (기본값) |
| Streamable HTTP | 웹 클라이언트, 원격 액세스 |
| Server-Sent Events | 레거시 클라이언트 |
midos-mcp config
지원되는 모든 MCP 클라이언트에 대해 바로 붙여넣을 수 있는 JSON 설정을 생성합니다.
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.jsonmidos-mcp health
서버 상태 확인: 지식 베이스 통계, 벡터 저장소 상태, 종속성.
midos-mcp health # Human-readable output
midos-mcp health --json # JSON output for scriptsmidos-mcp keys
계층적 액세스 제어를 위한 API 키를 관리합니다.
midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc계층: dev (무료), pro (월 $10), admin.
구성
환경 변수
변수 | 기본값 | 설명 |
| 자동 감지 | MidOS 설치 경로 (필수) |
|
| HTTP 서버 바인드 호스트 |
|
| HTTP 서버 바인드 포트 |
|
| 기본 전송 방식 |
루트 감지
서버는 MidOS 지식 베이스를 다음과 같이 찾습니다:
MIDOS_ROOT환경 변수 (권장)자동 감지: 패키지 위치에서 상위로 이동하며
CLAUDE.md+knowledge/를 찾음대체: 현재 작업 디렉토리
pip을 통해 설치한 경우, 자동 감지는 지식 베이스를 찾지 못합니다. 다음 중 하나를 수행하십시오:
# 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/midosmidos-mcp health로 확인하십시오. 감지된 루트와 지식 개수가 표시됩니다.
지원되는 클라이언트
클라이언트 | 설정 파일 | 전송 방식 |
Claude Desktop |
| stdio |
Claude Code |
| stdio |
Cursor |
| stdio |
Cline |
| stdio |
Windsurf |
| stdio |
Continue.dev |
| stdio |
Zed |
| stdio |
OpenCode |
| SSE |
선택적 종속성
# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]
# Development tools
pip install midos-mcp[dev]포함된 내용
MidOS는 2개 계층에 걸쳐 68개의 MCP 도구를 제공합니다:
계층 | 도구 | 액세스 |
Dev | 34개 도구 | 무료 — API 키 불필요, 전체 콘텐츠, 월 500회 쿼리 |
Pro | 68개 도구 | 월 $10 — 보안 운영, AOTC, 오케스트레이션, 메이커 쓰기 작업 |
기능
지식 — 모든 도메인에 걸쳐 46K+개의 큐레이팅된 청크 검색 (전체 콘텐츠, 잘림 없음)
기술 — 16개 이상의 기술 스택에 걸친 119개의 재사용 가능한 패턴
EUREKA — 측정된 ROI를 가진 383개의 검증된 개선 사항
진실 — 50개의 검증된 패치 및 수정 사항
SOTA — 140개의 최첨단 수렴 한계
벡터 검색 — LanceDB + Gemini 임베딩(3072-d)을 통한 의미론적 검색
속도 제한
계층 | 쿼리/월 | 콘텐츠 |
Dev | 500 | 전체 콘텐츠 (잘림 없음) |
Pro | 100,000 | 전체 콘텐츠 + AOTC + 운영 팩 |
유효하지 않거나 만료된 API 키는 자동으로 Dev 계층으로 전환됩니다.
요구 사항
Python 3.10+
FastMCP 2.x
MidOS 지식 베이스 (로컬)
라이선스
MIT
Available Tools
18 toolsagent_bootstrapA
[DEPRECATED -- use agent_handshake instead] Generic agent onboarding. Returns default config for unknown agents.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
agent_handshakeA
Personalized agent onboarding. Declare your environment and get optimal config.
Call this FIRST when connecting to MidOS. Pass as much info as you know. Unknown fields can be left empty -- you'll get sensible defaults.
Args: model: Your model ID (e.g. 'claude-opus-4-6', 'gemini-2.5-pro', 'opus') context_window: Your context window in tokens (e.g. 200000). 0 = auto-detect from model. client: Your CLI/IDE (e.g. 'claude-code', 'cursor', 'windsurf', 'cline') languages: Comma-separated languages (e.g. 'python,typescript') frameworks: Comma-separated frameworks (e.g. 'fastapi,react') platform: Your OS (e.g. 'windows', 'linux', 'macos') project_goal: What you're working on (e.g. 'manga engine with SVG rendering')
Inputs: model, client, platform, languages, +3 more. Returns: Generic wrapper for non-object return types.
chunk_codeA
Parse code file into semantic chunks (functions, classes, methods) for better RAG retrieval.
Args: file_path: Path to code file to chunk
Inputs: file_path (required). Returns: Generic wrapper for non-object return types.
episodic_searchA
Search episodic memory for similar past experiences using vector similarity.
Args: query: Search query describing the experience/task limit: Maximum results (default: 5)
Inputs: query (required), limit. Returns: Generic wrapper for non-object return types.
episodic_storeA
Store a new episodic memory/reflection for future learning.
Args: task_type: Type of task: CODE, RESEARCH, DEBUG, REVIEW input_preview: Brief description of the input/context success: Whether the task was successful
Inputs: task_type (required), input_preview (required), success. Returns: Generic wrapper for non-object return types.
get_eurekaB
Get a specific EUREKA breakthrough document.
Args: name: EUREKA name (e.g., 'EUREKA_CACHE_SEMANTICA' or 'ATOM_001')
Inputs: name (required). Returns: Generic wrapper for non-object return types.
get_protocolC
Get a specific protocol document.
Args: name: Protocol name (e.g., 'PROTOCOL_NEURAL_LINK')
Inputs: name (required). Returns: Generic wrapper for non-object return types.
get_skillB
Get a specific skill/capability document by name.
Args: name: Skill name (e.g., 'RAG_SYSTEMS_2026_SOTA')
Inputs: name (required). Returns: Generic wrapper for non-object return types.
get_truthC
Get a specific truth patch document.
Args: name: Truth patch name (e.g., 'AGENT_MITIGATIONS_CONTEXT_OVERFLOW')
Inputs: name (required). Returns: Generic wrapper for non-object return types.
hive_statusB
Get current status of the Midos hive system.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
list_skillsA
List all available skills/capabilities.
Args: filter: Optional filter for skill names stack: Optional stack filter, comma-separated (e.g. 'python,react'). Skills with matching compatibility.json are prioritized.
Inputs: stack, filter. Returns: Generic wrapper for non-object return types.
memory_statsA
Get statistics about the Midos memory system (LanceDB chunks, cache status).
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
pool_signalC
Signal an action to the multi-instance coordination pool.
Args: action: Action type: 'completed', 'blocked', 'claimed', 'signaling' topic: Topic/task name summary: Brief description of the action affects: Files/resources affected (optional)
Inputs: topic (required), action (required), summary (required), affects. Returns: Generic wrapper for non-object return types.
pool_statusB
Get multi-instance coordination pool status and recent activity.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
project_statusA
Live MidOS system status + quick-start guide for your agent.
Call this anytime to get:
Real-time knowledge base stats (chunks, skills, EUREKA, truth patches)
Vector store health
Available MCP tools with usage examples
Research queue (pending topics)
Tips to get the most out of MidOS
This is your /status command. Use it to orient yourself and teach your agent how to leverage MidOS.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
research_youtubeB
Queue a YouTube video for research. Midos will transcribe and extract insights.
Args: url: YouTube URL to research priority: Priority: 'high', 'normal', 'low'
Inputs: url (required), priority. Returns: Generic wrapper for non-object return types.
search_knowledgeC
Search the Midos knowledge base for relevant information.
Args: query: Search query (keywords or topic) max_results: Maximum results to return (default: 5)
Inputs: query (required), max_results. Returns: Generic wrapper for non-object return types.
semantic_searchA
Semantic search using LanceDB vectors (Gemini embeddings). More intelligent than keyword search.
Args: query: Natural language query (e.g., 'how to implement RAG pipelines') top_k: Number of results (default: 5) stack: Optional stack filter, comma-separated (e.g. 'python,fastapi'). Results mentioning these are boosted.
Inputs: query (required), stack, top_k. Returns: Generic wrapper for non-object return types.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Multiple tools have overlapping purposes. 'get_eureka', 'get_protocol', 'get_skill', and 'get_truth' all retrieve named documents with minimal distinction. Status tools like 'hive_status', 'memory_stats', 'pool_status', and 'project_status' also overlap, with 'project_status' subsuming many others. Additionally, a deprecated 'agent_bootstrap' adds confusion.
Tool names are consistently in snake_case, but the pattern is mixed: some start with verbs (get_, list_, chunk_), others with nouns (agent_, episodic_, hive_). This inconsistency makes it harder for an agent to predict tool names, though they remain readable.
With 18 tools, the server is on the higher end of the recommended range. While each tool has a distinct function, the count feels slightly heavy for a research protocol, especially given the overlaps. It could be streamlined.
The server covers onboarding, memory, knowledge retrieval, status monitoring, and research queuing, but lacks write operations for many document types (e.g., no create/update for skills, eurekas, or protocols). The research queue only has an enqueue tool, with no management or listing beyond status.
Maintenance
Related MCP Connectors
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
Executable skill packages for agents: vetted competence, ready to run, not just documents.
Governance copilot for AI-assisted coding. 72 packs, 532 rules, proof bundles.
Search 1,700+ agent skills for Claude, Codex and Cursor, each safety-scanned, with proofs.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables 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.367-
- FlicenseBqualityNot gradedmaintenanceTurns 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.3513 npm-
- AlicenseAqualityFmaintenanceProvides access to a library of 18 specialized skills, project templates, and prompt patterns for Claude Code. It enables automated workflows for feature development, security audits, and system maintenance through multi-agent collaboration.6MIT
- AlicenseAqualityDmaintenanceProvides 634+ curated production-ready AI skills for any MCP-compatible client, covering areas like security, frontend, backend, infrastructure, AI/ML, and architecture. Enables AI agents to access best practices, patterns, and solutions across multiple domains.61MIT