Yasin-MCP

Yasin 생태계를 위한 독립형 AI/에이전트 지향 MCP(Model Context Protocol) 접근 및 통합 계층입니다.

사명

Yasin-MCP는 MCP 프로토콜을 통해 Yasin 생태계 정보(프로젝트 레지스트리, 문서, GitHub 저장소 상태, 런타임 진단)에 대한 읽기 전용의 구조화된 접근을 제공하여, AI 에이전트와 MCP 클라이언트가 개별 저장소나 서비스에 대한 직접적이고 무제한적인 접근 없이도 생태계 상태를 조회할 수 있게 합니다.

Related MCP server: conda-meta-mcp

상태

Phase 0, Issue #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에 대한 언급이 발견되지 않았습니다.

이는 여기서 구현된 아키텍처가 현재 존재하지 않는 YASIN-DOCS 문서가 아니라 이 프로젝트 자체의 Issue #1–#10 설명(상세하고 자체적으로 일관됨)에서 직접 파생되었음을 의미합니다. YASIN-DOCS가 Yasin-MCP를 포함하도록 업데이트되면 그것이 진실의 원천이 되어야 하며, 이 참고 사항은 제거되거나 현재 위치를 반영하도록 업데이트되어야 합니다.

아키텍처 경계

• Yasin-MCP는 YASIN-DOCS, Yasin-Core, Yasin-Agent, Yasin-AI, YasinHub, YasinCLI 또는 Yasin-Operations를 대체하지 않습니다.

• Phase 1은 엄격히 읽기 전용입니다: 저장소 변경, 배포, 수명 주기 변경(시작/중지/재시작), 메모리 변경, 임의 셸/명령 실행이 없습니다.

• 비공개 교차 저장소 가져오기는 없습니다. 통합은 공개 API, SDK, 계약 또는 명시적 읽기 전용 어댑터를 사용합니다.

• 기존 Yasin 프로젝트는 Yasin-MCP에 의존하게 되어서는 안 됩니다.

• 기본 거부 정책 경계(policies/policy.py)는 금지된 패턴(exec, shell, command, request, arbitrary, filesystem, deploy, delete, start_/stop_/restart_)과 일치하는 이름을 가진 기능이나 Phase 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