Yasin-MCP

Yasinエコシステム向けの、AI/エージェント向けのスタンドアロンMCP（Model Context Protocol）アクセスおよび統合レイヤー。

ミッション

Yasin-MCPは、Yasinエコシステムの情報（プロジェクトレジストリ、ドキュメント、GitHubリポジトリの状態、ランタイム診断）への読み取り専用の構造化アクセスをMCPプロトコルを通じて公開し、AIエージェントやMCPクライアントが、個々のリポジトリやサービスへの直接の無制限アクセスを必要とせずにエコシステムの状態を照会できるようにします。

Related MCP server: conda-meta-mcp

ステータス

フェーズ0、Issue #1（リポジトリブートストラップとエンジニアリングベースライン）のみ。 MCPサーバーランタイムはまだ存在しません。ドメインアダプター（YASIN-DOCS、GitHub、Yasin-Operations）もまだ存在しません。このIssueは、パッケージ構造、ツール、およびその他すべてが基盤とする安全プリミティブ（エラーモデル、デフォルト拒否ポリシー、シークレット処理）のみを確立します。

アーキテクチャの由来に関する注記

このプロジェクトの元のタスク説明では、YASIN-DOCSは「Yasin-MCPの正規のアーキテクチャおよび境界」であると述べられています。yusi20006-max/YASIN-DOCSリポジトリ（「Yasin-MCP」/「MCP」のコード検索と、PROJECT_REGISTRY.yamlおよびECOSYSTEM.mdの直接確認の両方）に対する直接検証では、このIssueの時点でそのリポジトリ内に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を置き換えません。

• フェーズ1は厳密に読み取り専用です：リポジトリの変更、デプロイ、ライフサイクル変更（開始/停止/再起動）、メモリ変更、任意のシェル/コマンド実行はありません。

• プライベートなクロスリポジトリインポートはありません。統合は、公開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