MCP 서버 프로젝트

이 프로젝트에는 고객 인터뷰, E2E 테스트, 가동 프로세스 등 다양한 작업을 처리하는 여러 대의 MCP 서버가 포함되어 있습니다. 각 MCP 서버는 FastMCP 프레임워크를 사용하여 구현되었습니다.

필수 조건

• Python 3.11 이상

• uv 패키지 관리자( pip 대신 사용)

Related MCP server: mcp-dev-servers

설정

1. 저장소를 복제합니다.

   지엑스피1

2. uv 사용하여 종속성을 설치합니다.

   uv install

프로젝트 실행

특정 MCP 서버를 실행하려면 다음 명령을 사용하세요.

uv run main.py --mcp <mcp_server_name>

<mcp_server_name> 실행할 MCP 서버 이름으로 바꾸세요. 사용 가능한 옵션은 다음과 같습니다.

• hello

• customer_mcp

• interview_mcp

• go_live_mcp

• testing_e2e_mcp

예

customer_mcp 서버를 실행하려면:

uv run main.py --mcp customer_mcp

이렇게 하면 customer_mcp 서버가 시작되고 다음 위치에서 액세스할 수 있습니다.

http://127.0.0.1:8000/customer-mcp-server/mcp

Docker Compose로 실행

Docker Compose를 사용하면 모든 MCP 서버를 동시에 실행할 수 있습니다. 각 서버는 서로 다른 포트에 노출됩니다.

실행 단계

1. 모든 서비스를 빌드하고 시작합니다.

   docker-compose up --build

2. 다음 URL에서 MCP 서버에 액세스하세요.

   • hello-mcp : http://127.0.0.1:8000/hello-server/mcp

   • customer-mcp : http://127.0.0.1:8001/customer-mcp-server/mcp

   • interview-mcp : http://127.0.0.1:8002/interview-mcp-server/mcp

   • go-live-mcp : http://127.0.0.1:8003/go-live-mcp-server/mcp

   • testing-e2e-mcp : http://127.0.0.1:8004/ 테스트-e2e-mcp-서버/mcp

3. 모든 서비스를 중지합니다:

   docker-compose down

노트

• 시스템에 Docker와 Docker Compose가 설치되어 있는지 확인하세요.

• 각 MCP 서버는 자체 컨테이너에서 실행되며 해당 포트에서 액세스할 수 있습니다.

VSCode에서 MCP 서버 구성

VSCode에서 MCP 서버를 구성하려면 settings.json 파일의 mcp.servers 섹션에 항목을 추가하세요. 이렇게 하면 MCP 서버 엔드포인트를 정의하고 관리하여 쉽게 액세스할 수 있습니다.

구성 예

hello-mcp-server 구성하려면 settings.json 파일에 다음 항목을 추가하세요.

"hello-mcp-server": {
    "url": "http://127.0.0.1:8000/hello-server/mcp/http",
    "type": "http"
}

그런 다음 Copilot에서 #hello <something> 실행하여 hello server hello 도구에 액세스할 수 있습니다.

구성 추가 단계

1. VSCode settings.json 파일을 엽니다.

2. mcp.servers 섹션을 찾거나 만듭니다.

3. 위의 예와 같이 원하는 MCP 서버에 대한 구성을 추가합니다.

서버 접속

구성이 완료되면 정의된 URL을 사용하여 MCP 서버와 상호 작용할 수 있습니다. 예를 들어, hello-mcp-server 다음 위치에서 액세스할 수 있습니다.

http://127.0.0.1:8000/hello-server/mcp/http

이 설정을 사용하면 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 서버를 지정합니다.