Yasin-MCP

Автономный уровень доступа и интеграции MCP (Model Context Protocol) для ИИ/агентов в экосистеме Yasin.

Миссия

Yasin-MCP предоставляет доступ только для чтения и структурированный доступ к информации экосистемы Yasin (реестр проектов, документация, состояние репозитория GitHub, диагностика выполнения) через протокол MCP, чтобы ИИ-агенты и MCP-клиенты могли запрашивать состояние экосистемы без необходимости прямого неограниченного доступа к какому-либо отдельному репозиторию или сервису.

Related MCP server: conda-meta-mcp

Статус

Только фаза 0, проблема №1 (начальная настройка репозитория и инженерный базовый уровень). Сервер MCP пока не существует. Адаптеры доменов (YASIN-DOCS, GitHub, Yasin-Operations) пока не существуют. Эта проблема только устанавливает структуру пакета, инструменты и примитивы безопасности (модель ошибок, политику запрета по умолчанию, обработку секретов), на которых будет строиться всё остальное.

Примечание о происхождении архитектуры

В исходном описании задачи для этого проекта указано, что YASIN-DOCS является «канонической архитектурой и границей» для Yasin-MCP. Прямая проверка репозитория yusi20006-max/YASIN-DOCS (и поиск по коду «Yasin-MCP»/«MCP», и прямая проверка PROJECT_REGISTRY.yaml и ECOSYSTEM.md) показала, что в этом репозитории нет упоминаний Yasin-MCP на момент создания этой проблемы.

Это означает, что реализованная здесь архитектура напрямую выведена из описаний проблем №1–№10 этого проекта (которые подробны и непротиворечивы), а не из документа YASIN-DOCS, которого в настоящее время не существует. Если/когда YASIN-DOCS будет обновлён и включит Yasin-MCP, этот документ должен стать источником истины, а это примечание следует удалить или обновить, указав, где он теперь находится.

Архитектурные границы

• Yasin-MCP не заменяет YASIN-DOCS, Yasin-Core, Yasin-Agent, Yasin-AI, YasinHub, YasinCLI или Yasin-Operations.

• Фаза 1 строго только для чтения: никаких изменений в репозиториях, развертывания, изменения жизненного цикла (запуск/остановка/перезапуск), изменения памяти, произвольного выполнения shell/команд.

• Никаких частных импортов между репозиториями. Интеграции используют публичные API, SDK, контракты или явные адаптеры только для чтения.

• Существующие проекты Yasin не должны зависеть от Yasin-MCP.

• Политика запрета по умолчанию (policies/policy.py) отклоняет любую возможность, имя которой соответствует запрещённому шаблону (exec, shell, command, request, arbitrary, filesystem, deploy, delete, start_/stop_/restart_) или которая объявляет себя изменяющей, пока действует фаза 1 — применяется на этапе конструирования, а не только при регистрации.

Структура пакета

src/yasin_mcp/
    server/        MCP server runtime (Issue #4)
    protocol/       MCP protocol types/boundary (Issue #2)
    capabilities/   capability descriptor + discovery (Issue #2)
    tools/          MCP tool implementations (Issue #4+)
    resources/      MCP resource implementations (Issue #4+)
    adapters/       domain adapters: YASIN-DOCS, GitHub, Yasin-Operations (Issue #5-7)
    policies/       deny-by-default policy boundary
    errors/         structured error model (McpError + ErrorCategory)
    audit/          structured logging, correlation IDs
    config/         configuration model, secret handling
    version.py      package version, EvidenceStatus enum

Модель доказательств

Ответы, сообщающие о состоянии экосистемы, должны помечать информацию одним из следующих способов:

• CONFIRMED — непосредственно наблюдалось из живого авторитетного источника

• TARGET — задокументированное намерение/архитектура, не проверено на работающей системе

• PROPOSED — предложение или план, ещё нигде не реализовано

• UNRESOLVED — не удалось определить; не должно представляться как факт

Разработка

pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .
mypy src
bandit -q -r src