3 - MCP 서버 설정 및 Cursor IDE 연동 방법 (기초편)

이번 글에서는 외부 MCP(Model Context Protocol) 서버를 설정하고 이를 Cursor IDE와 연동하는 방법을 단계별로 자세히 알아봅니다. MCP 서버는 데이터베이스, 외부 API, 파일 시스템 등 다양한 리소스를 표준화된 방식으로 제공하여, AI 모델이 효과적으로 활용할 수 있게 지원합니다.

---

📌 MCP 서버란 무엇인가?

MCP 서버는 데이터베이스, 외부 API, 로컬 파일 시스템과 같은 다양한 외부 리소스를 AI 모델이 쉽게 접근할 수 있도록 표준화된 인터페이스를 제공합니다. MCP를 통해 AI는 외부 데이터를 조회하거나 특정 작업을 직접 수행할 수 있어, 반복적이고 수동적인 업무를 크게 줄이고 생산성을 높일 수 있습니다.

MCP 서버는 표준 JSON 인터페이스를 통해 AI 모델과 통신하며, 직관적인 방식으로 다양한 외부 시스템과 연동할 수 있도록 도와줍니다.

---

🔧 MCP 서버의 주요 유형과 선택 방법

MCP 서버는 용도에 따라 다양한 유형으로 구분됩니다. 대표적인 MCP 서버의 종류는 다음과 같습니다:

• PostgreSQL MCP 서버: AI 모델이 PostgreSQL 데이터베이스의 데이터를 직접 조회하고 분석할 수 있도록 돕습니다.
• Filesystem MCP 서버: 로컬 파일 시스템 내 문서와 데이터를 AI 모델이 접근하여 활용할 수 있게 지원합니다.
• API MCP 서버: AI 모델이 외부 API를 직접 호출하여 데이터를 가져오고 처리할 수 있도록 돕습니다.

이외에도 GitHub MCP 서버, Google Drive MCP 서버와 같이 여러 특화된 MCP 서버가 존재하므로, 필요한 작업과 환경에 맞는 MCP 서버를 선택하여 설정할 수 있습니다.

 

 

⚙️ Cursor IDE와 MCP 서버 연동하기

MCP 서버를 Cursor IDE와 연결하여 실질적으로 활용해 봅니다.

연동 전 준비 사항

• Node.js와 npm을 미리 설치합니다.
• PostgreSQL 데이터베이스가 로컬이나 원격 서버에 준비되어 있어야 합니다.

설치 확인

터미널(명령 프롬프트 또는 PowerShell)에서 Node.js 설치 여부를 확인합니다:

node -v
npm -v

Cursor IDE에 MCP 서버 추가하기

1. Cursor Setting에서 "MCP" 탭으로 이동합니다.
2. MCP Servers 섹션에서 "Add new global MCP server" 버튼을 클릭합니다.
3. mcp.json 파일을 아래처럼 작성합니다.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://username:password@localhost:5432/dbname"
      ]
    }
  }
}

여기서 각 항목은 다음과 같이 입력합니다:

• username: 데이터베이스 접속 사용자 이름
• password: 데이터베이스 사용자 암호
• localhost: 데이터베이스 서버의 주소 (원격 서버일 경우 IP 주소 또는 도메인 사용)
• 5432: PostgreSQL 서버 포트 번호 (기본값)
• dbname: 연결할 데이터베이스 이름

1. 정보를 모두 입력한 후 MCP Servers 목록에 "postgres"가 추가되었는지 확인합니다.
2. MCP Servers  목록에서 "postgres"가 활성 상태(초록색 점)로 표시되는지 확인합니다. (초록색 표시가 될때까지 몇초정도 걸릴 수 있음)

---

✅ MCP 서버와의 연동 상태 확인하기

MCP 서버가 정상적으로 연동되었는지 실제로 확인해 봅니다.

연동 테스트 수행

• Cursor IDE의 AI 챗 패널에서 다음과 같은 간단한 요청을 입력해 봅니다:

  데이터베이스에 저장된 테이블 이름들을 보여줘.
  

• 예시 명령:
• 정상적으로 데이터베이스의 테이블 목록이 표시되면 MCP 서버와의 연동이 성공적으로 완료된 것입니다.
• 만약 오류가 발생하거나 결과가 나오지 않는다면, 서버 로그와 입력한 연결 정보를 다시 점검해 보세요.

---

🔍 다음 편 예고

다음 글에서는 MCP 서버를 활용하여 데이터베이스 쿼리를 자동화하는 구체적인 방법과 예시를 살펴보겠습니다. AI를 활용한 데이터 관리 및 분석 자동화 기술을 익혀 실무에 빠르게 적용해 보세요!

다음 글: 4 - MCP로 데이터베이스 쿼리 자동화하기 (실전편①)