MCP 서버 프로젝트
이 프로젝트에는 고객 인터뷰, E2E 테스트, 가동 프로세스 등 다양한 작업을 처리하는 여러 대의 MCP 서버가 포함되어 있습니다. 각 MCP 서버는 FastMCP 프레임워크를 사용하여 구현되었습니다.
필수 조건
Python 3.11 이상
uv패키지 관리자(pip대신 사용)
Related MCP server: FastMCP Boilerplate
설정
저장소를 복제합니다.
지엑스피1
uv사용하여 종속성을 설치합니다.uv install
프로젝트 실행
특정 MCP 서버를 실행하려면 다음 명령을 사용하세요.
<mcp_server_name> 실행할 MCP 서버 이름으로 바꾸세요. 사용 가능한 옵션은 다음과 같습니다.
hellocustomer_mcpinterview_mcpgo_live_mcptesting_e2e_mcp
예
customer_mcp 서버를 실행하려면:
이렇게 하면 customer_mcp 서버가 시작되고 다음 위치에서 액세스할 수 있습니다.
Docker Compose로 실행
Docker Compose를 사용하면 모든 MCP 서버를 동시에 실행할 수 있습니다. 각 서버는 서로 다른 포트에 노출됩니다.
실행 단계
모든 서비스를 빌드하고 시작합니다.
docker-compose up --build다음 URL에서 MCP 서버에 액세스하세요.
hello-mcp: http://127.0.0.1:8000/hello-server/mcpcustomer-mcp: http://127.0.0.1:8001/customer-mcp-server/mcpinterview-mcp: http://127.0.0.1:8002/interview-mcp-server/mcpgo-live-mcp: http://127.0.0.1:8003/go-live-mcp-server/mcptesting-e2e-mcp: http://127.0.0.1:8004/ 테스트-e2e-mcp-서버/mcp
모든 서비스를 중지합니다:
docker-compose down
노트
시스템에 Docker와 Docker Compose가 설치되어 있는지 확인하세요.
각 MCP 서버는 자체 컨테이너에서 실행되며 해당 포트에서 액세스할 수 있습니다.
VSCode에서 MCP 서버 구성
VSCode에서 MCP 서버를 구성하려면 settings.json 파일의 mcp.servers 섹션에 항목을 추가하세요. 이렇게 하면 MCP 서버 엔드포인트를 정의하고 관리하여 쉽게 액세스할 수 있습니다.
구성 예
hello-mcp-server 구성하려면 settings.json 파일에 다음 항목을 추가하세요.
그런 다음 Copilot에서 #hello <something> 실행하여 hello server hello 도구에 액세스할 수 있습니다.
구성 추가 단계
VSCode
settings.json파일을 엽니다.mcp.servers섹션을 찾거나 만듭니다.위의 예와 같이 원하는 MCP 서버에 대한 구성을 추가합니다.
서버 접속
구성이 완료되면 정의된 URL을 사용하여 MCP 서버와 상호 작용할 수 있습니다. 예를 들어, hello-mcp-server 다음 위치에서 액세스할 수 있습니다.
이 설정을 사용하면 VSCode에서 직접 MCP 서버를 쉽게 관리하고 테스트할 수 있습니다.
프로젝트 구조
main.py: MCP 서버를 실행하기 위한 진입점.customer_mcp.py: 고객 인터뷰 관련 업무를 처리합니다.interview_mcp.py: 고객 인터뷰 단계를 관리합니다.go_live_mcp.py: 라이브 프로세스를 처리합니다.testing_e2e_mcp.py: E2E 테스트 작업을 관리합니다.hello.py: 테스트를 위한 MCP 서버 예시.
노트
uv패키지 관리자가 올바르게 설치되고 구성되었는지 확인하세요.--mcp인수를 사용하여 실행할 MCP 서버를 지정합니다.