midos-mcp

MidOS MCP 커뮤니티 라이브러리 — MCP 도구로서의 지식, 기술 및 연구.

한 번 설치하면 모든 AI 클라이언트에 연결할 수 있습니다.

설치

pip install midos-mcp

요구 사항: MidOS 지식 베이스를 로컬에서 사용할 수 있어야 합니다. MIDOS_ROOT 환경 변수를 설정하여 MidOS 설치 디렉토리(knowledge/ 및 modules/를 포함하는 디렉토리)를 가리키도록 하십시오.

export MIDOS_ROOT=/path/to/midos

빠른 시작

# 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`	stdio	Claude Code, Cursor, Cline (기본값)
`--http`	Streamable HTTP	웹 클라이언트, 원격 액세스
`--sse`	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.json

`midos-mcp health`

서버 상태 확인: 지식 베이스 통계, 벡터 저장소 상태, 종속성.

midos-mcp health          # Human-readable output
midos-mcp health --json   # JSON output for scripts

`midos-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_ROOT`	자동 감지	MidOS 설치 경로 (필수)
`MIDOS_HOST`	`127.0.0.1`	HTTP 서버 바인드 호스트
`MIDOS_PORT`	`8419`	HTTP 서버 바인드 포트
`MIDOS_TRANSPORT`	`stdio`	기본 전송 방식

루트 감지

서버는 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/midos

midos-mcp health로 확인하십시오. 감지된 루트와 지식 개수가 표시됩니다.

지원되는 클라이언트

클라이언트	설정 파일	전송 방식
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

선택적 종속성

# 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

MidOS Research Protocol