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

midos-mcp config

Генерация готовой к вставке JSON-конфигурации для любого поддерживаемого MCP-клиента.

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 следующим образом:

1. Переменная окружения MIDOS_ROOT (рекомендуется)

2. Автоопределение: поиск вверх от расположения пакета до нахождения CLAUDE.md + knowledge/

3. Резервный вариант: текущая рабочая директория

Если вы установили через 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 — команда покажет обнаруженный путь и количество элементов базы знаний.

Поддерживаемые клиенты

Дополнительные зависимости

# Vector store support (LanceDB + embeddings)
pip install midos-mcp[vector]

# Development tools
pip install midos-mcp[dev]

Что внутри

MidOS предоставляет 68 инструментов MCP на 2 уровнях:

Возможности

• Знания — Поиск по 46K+ отобранным фрагментам во всех доменах (полный контент, без сокращений)

• Навыки — 119 повторно используемых шаблонов по 16+ технологическим стекам

• EUREKA — 383 подтвержденных улучшения с измеренным ROI

• Истина — 50 проверенных патчей и исправлений

• SOTA — 140 передовых потолков конвергенции

• Векторный поиск — Семантический поиск через LanceDB + эмбеддинги Gemini (3072-d)

Лимиты запросов

Недействительные или истекшие API-ключи автоматически переводят пользователя на уровень Dev.

Требования

• Python 3.10+

• FastMCP 2.x

• База знаний MidOS (локально)

Лицензия

MIT