유니버설 MCP 랩

동적 기능 획득을 검증하기 위한 최소 개념 증명 — 안정적인 MCP 표면 뒤에서.

가설

에이전트는 여섯 개의 안정적인 도구로 시작합니다. OpenAPI 서비스를 연결하고, 새로운 내부 기능을 발견하고, 이를 검사하고, 게시된 MCP 카탈로그를 수정하지 않고 호출합니다.

예정된 안정적인 표면:

• services.connect

• services.disconnect

• services.list

• capabilities.list

• capabilities.describe

• capabilities.invoke

PoC는 장비에 대한 원시 접근을 제공하지 않으며, 임의의 셸을 노출하지 않고, 자격 증명을 저장하지 않습니다.

Related MCP server: openapi-mcp

로컬 테스트 실행

python -m unittest discover -s tests -v
python scripts/demo.py

stdio를 통한 실제 MCP

3단계는 여섯 개의 안정적인 도구를 갖춘 실제 MCP 서버를 통합합니다. 선언된 종속성을 설치하고 MCP 호스트가 프로세스를 시작하도록 합니다:

pip install -e .
python -m entradas.mcp.server

프로세스는 인터페이스를 표시하지 않으며 stdout에 써서는 안 됩니다: stdin을 통해 MCP 메시지를 기다립니다. tests/test_mcp_protocol.py 테스트는 실제 MCP 클라이언트 역할을 하며, tools/list를 확인하고, 합성 OpenAPI를 연결하고, 공개 카탈로그가 변경되지 않았는지 확인합니다.

이 로컬 전송은 의도적으로 제한되어 있습니다: HTTP를 게시하지 않고, OAuth를 포함하지 않으며, PC를 연결하지 않고, 쓰기 승인을 활성화하지 않습니다.

실험실에서 HTTP 읽기 활성화

시작 전에 로컬 허용 목록을 구성합니다. MCP를 통해 전송된 OpenAPI 문서는 해당 대상을 수정할 수 없습니다:

$env:UNIVERSAL_MCP_READ_BASE_URLS = '{"customers":"https://api.example.test"}'
python -m entradas.mcp.server

구성된 서비스에 대해서만 GET이 실행됩니다; 타임아웃, 크기 제한, 필수 JSON, 리디렉션 없음 및 재시도 없음이 적용됩니다. 스위트는 인터넷을 사용하지 않습니다: 이 흐름을 검증하기 위해 로컬 임시 엔드포인트를 시작합니다.

소유자 PC의 로컬 노드

PC 노드는 별도의 로컬 MCP 프로세스이며, 원격 제어 함수가 아닙니다. 장비 소유자만 시작하고 명시적 폴더를 지정할 수 있습니다:

$env:UNIVERSAL_MCP_OWNER_ALLOWED_ROOT = 'C:\carpeta-autorizada'
python -m entradas.pc_node.server

유일한 도구는 pc.read_text(relative_path)입니다. 셸, 쓰기, 디스크 탐색, 브라우저, 프로세스 또는 네트워크 리스너를 포함하지 않습니다. 게이트웨이와 이 노드 사이의 터널 및 인증은 이후 단계에 속합니다.

쓰기 작업 경계

쓰기는 approved=true를 허용하지 않습니다. 첫 번째 요청은 확인 참조를 반환합니다; 신뢰할 수 있는 인간 인터페이스가 MCP 외부에서 해당 정확한 작업을 승인해야 합니다. 결과 권한 부여는 일회용이며, 동일한 인수에 묶여 있으며, 실행자 이전에 소비됩니다. 이는 PC 노드에 대한 쓰기를 아직 활성화하지 않습니다.

상태

아키텍처 + 실험실 코어 + 심층 ECA가 준비되었습니다. STATUS.md 및 docs/PLAYBOOK.md를 참조하십시오.