MCP 개념 증명

이 저장소에는 FastAPI 로 구현된 간단한 모델 컨텍스트 프로토콜(MCP) 서버가 포함되어 있습니다. AWS Fargate에 배포할 수 있는 검색 가능하고 버전이 지정된 API를 통해 가축 데이터를 제공하는 것이 목표입니다.

지역적으로 실행

1. 종속성 설치:

   데이터베이스 경로는 DATABASE_PATH 환경 변수를 통해 설정할 수 있습니다. 설정하지 않으면 작업 디렉터리 내의 mcp.db 기본값으로 사용됩니다.

   지엑스피1

2. SQLite 데이터베이스 시드:

   python -m app.seed

3. API 서버를 시작합니다.

   uvicorn app.main:app --reload

4. API를 호출할 때 토큰 fake-super-secret-token 으로 인증합니다.

MCP 검색 파일은 model_context.yaml 에서 사용할 수 있습니다.

Related MCP server: MyAIServ MCP Server

에이전트를 사용하여

MCP 서버와 상호 작용하기 위한 agent 패키지가 제공됩니다. 서버가 실행되면 다음과 같이 가축 데이터를 나열할 수 있습니다.

python -m agent http://localhost:8000 --token fake-super-secret-token

에이전트는 model_context.yaml 파일을 읽어 API 경로를 확인하고 서버에서 JSON 응답을 반환합니다. YAML을 완벽하게 지원하려면 PyYAML 종속성을 설치해야 합니다. 그렇지 않으면 제한된 내장 파서가 사용됩니다.

테스트 실행

pytest -q

컨테이너

컨테이너에서 서버를 실행하기 위해 Dockerfile 이 제공됩니다. 다음을 사용하여 빌드하세요.

docker build -t mcp .

테라폼

terraform 디렉터리에는 컨테이너를 AWS(예: Fargate)에 배포하는 방법을 보여주는 최소 구성이 포함되어 있습니다. 이 디렉터리는 이미지에 대한 ECR 저장소를 생성합니다.