Yasin-MCP

Capa MCP (Model Context Protocol) de acceso e integración, independiente y orientada a IA/agentes, para el ecosistema Yasin.

Misión

Yasin-MCP expone acceso de solo lectura y estructurado a la información del ecosistema Yasin (registro de proyectos, documentación, estado del repositorio de GitHub, diagnósticos de ejecución) a través del protocolo MCP, de modo que los agentes de IA y los clientes MCP puedan consultar el estado del ecosistema sin necesitar acceso directo e ilimitado a ningún repositorio o servicio individual.

Related MCP server: conda-meta-mcp

Estado

Solo Fase 0, Issue #1 (Repository Bootstrap and Engineering Baseline). Aún no existe ningún entorno de ejecución de servidor MCP. Aún no existe ningún adaptador de dominio (YASIN-DOCS, GitHub, Yasin-Operations). Esta issue solo establece la estructura del paquete, las herramientas y las primitivas de seguridad (modelo de errores, política de denegación por defecto, gestión de secretos) sobre las que se construirá todo lo demás.

Una nota sobre la procedencia de la arquitectura

La descripción de la tarea original de este proyecto indica que YASIN-DOCS es "la arquitectura y el límite canónicos" para Yasin-MCP. La verificación directa contra el repositorio yusi20006-max/YASIN-DOCS (tanto una búsqueda de código de "Yasin-MCP"/"MCP" como una comprobación directa de PROJECT_REGISTRY.yaml y ECOSYSTEM.md) no encontró ninguna mención a Yasin-MCP en ese repositorio a fecha de esta issue.

Esto significa que la arquitectura implementada aquí se deriva directamente de las descripciones de las Issues #1–#10 de este propio proyecto (que son detalladas y coherentes), no de un documento de YASIN-DOCS que actualmente no existe. Si/cuando YASIN-DOCS se actualice para incluir Yasin-MCP, ese debería convertirse en la fuente de verdad y esta nota debería eliminarse o actualizarse para reflejar dónde vive ahora.

Límite de la arquitectura

• Yasin-MCP no reemplaza a YASIN-DOCS, Yasin-Core, Yasin-Agent, Yasin-AI, YasinHub, YasinCLI ni Yasin-Operations.

• La Fase 1 es estrictamente de solo lectura: sin mutación de repositorios, sin despliegue, sin mutación del ciclo de vida (start/stop/restart), sin mutación de memoria, sin ejecución arbitraria de shell/comandos.

• Sin importaciones privadas entre repositorios. Las integraciones utilizan API, SDK y contratos públicos, o bien adaptadores explícitos de solo lectura.

• Los proyectos Yasin existentes no deben volverse dependientes de Yasin-MCP.

• Un límite de política de denegación por defecto (policies/policy.py) rechaza cualquier capacidad cuyo nombre coincida con un patrón prohibido (exec, shell, command, request, arbitrary, filesystem, deploy, delete, start_/stop_/restart_) o que se declare mutante mientras la Fase 1 esté en vigor — se aplica en el momento de la construcción, no solo en el registro.

Estructura del paquete

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

Modelo de evidencia

Las respuestas que informan sobre el estado del ecosistema deberían etiquetar la información con una de las siguientes opciones:

• CONFIRMED — observado directamente de una fuente autoritativa y activa

• TARGET — intención/arquitectura documentada, no verificada contra un sistema en ejecución

• PROPOSED — una sugerencia o plan, aún no implementado en ningún sitio

• UNRESOLVED — no se pudo determinar; no debe presentarse como un hecho

Desarrollo

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