MidOS Research Protocol
Protocolo de Pesquisa MidOS: habilidades e conhecimento selecionados e versionados.
Documentação
midos-mcp
MidOS MCP Community Library — Conhecimento, Habilidades e Pesquisa como ferramentas MCP.
Instale uma vez, conecte-se a qualquer cliente de IA.
Instalação
pip install midos-mcp
Requisito: A base de conhecimento MidOS deve estar disponível localmente. Defina a variável de ambiente MIDOS_ROOT para apontar para o diretório de instalação do MidOS (aquele que contém knowledge/ e modules/).
export MIDOS_ROOT=/path/to/midos
Início Rápido
# 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
Comandos
midos-mcp serve
Inicie o servidor MCP com o transporte de sua preferência.
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 | Transporte | Caso de Uso |
|---|---|---|
--stdio | stdio | Claude Code, Cursor, Cline (padrão) |
--http | Streamable HTTP | Clientes web, acesso remoto |
--sse | Server-Sent Events | Clientes legados |
midos-mcp config
Gere configuração JSON pronta para colar para qualquer cliente MCP suportado.
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
Verifique a saúde do servidor: estatísticas da base de conhecimento, status do armazenamento vetorial, dependências.
midos-mcp health # Human-readable output
midos-mcp health --json # JSON output for scripts
midos-mcp keys
Gerencie chaves de API para controle de acesso em camadas.
midos-mcp keys generate --name "my-app" --tier dev
midos-mcp keys list
midos-mcp keys revoke midos_sk_abc
Camadas: dev (gratuito), pro ($10/mês), admin.
Configuração
Variáveis de Ambiente
| Variável | Padrão | Descrição |
|---|---|---|
MIDOS_ROOT | auto-detect | Caminho para a instalação do MidOS (obrigatório) |
MIDOS_HOST | 127.0.0.1 | Host de ligação do servidor HTTP |
MIDOS_PORT | 8419 | Porta de ligação do servidor HTTP |
MIDOS_TRANSPORT | stdio | Transporte padrão |
Detecção de Raiz
O servidor localiza a base de conhecimento MidOS:
- Variável de ambiente
MIDOS_ROOT(recomendado) - Auto-detecção: sobe a partir do local do pacote procurando por
CLAUDE.md+knowledge/ - Fallback: diretório de trabalho atual
Se você instalou via pip, a auto-detecção não encontrará a base de conhecimento. Ou:
# 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
Verifique com midos-mcp health — ele mostra a raiz detectada e as contagens de conhecimento.
Clientes Suportados
| Cliente | Arquivo de Configuração | Transporte |
|---|---|---|
| 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 |
Dependências Opcionais
# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]
# Development tools
pip install midos-mcp[dev]
O que está Incluído
MidOS expõe 68 ferramentas MCP em 2 camadas:
| Camada | Ferramentas | Acesso |
|---|---|---|
| Dev | 34 ferramentas | Gratuito — sem necessidade de chave de API, conteúdo completo, 500 consultas/mês |
| Pro | 68 ferramentas | $10/mês — operações de segurança, AOTC, orquestração, operações de escrita maker |
Recursos
- Conhecimento — Pesquise 46K+ blocos curados em todos os domínios (conteúdo completo, sem truncamento)
- Habilidades — 119 padrões reutilizáveis em mais de 16 pilhas de tecnologia
- EUREKA — 383 melhorias validadas com ROI medido
- Verdade — 50 correções e patches verificados
- SOTA — 140 tetos de convergência de última geração
- Pesquisa Vetorial — Pesquisa semântica via LanceDB + embeddings Gemini (3072-d)
Limites de Taxa
| Camada | Consultas/mês | Conteúdo |
|---|---|---|
| Dev | 500 | Conteúdo completo (sem truncamento) |
| Pro | 100.000 | Conteúdo completo + AOTC + pacotes de operações |
Chaves de API inválidas ou expiradas caem silenciosamente para a camada Dev.
Requisitos
- Python 3.10+
- FastMCP 2.x
- Base de conhecimento MidOS (local)
Licença
MIT