본문 바로가기

StockBot

한국투자 코딩도우미 MCP를 파이참에 연결하는 방법

 
 
한국투자 코딩도우미 MCP를 파이참(PyCharm)에 연결하는 방법은 파이참의 
AI Assistant 기능을 통해 MCP 서버를 설정하는 방식으로 이루어집니다. 
자세한 단계는 다음과 같습니다.
준비물
  • 한국투자증권 Open API 사용을 위한 API 키 (My Page에서 발급)
  • 파이참 IDE (AI Assistant 플러그인이 활성화되어 있어야 함)
  • 로컬 환경에 한국투자 코딩도우미 MCP 서버 실행을 위한 Node.js 및 관련 패키지 설치 
파이참 연결 단계
  1. 파이참 설정 열기:
    • 파이참 상단 메뉴에서 File > Settings (macOS에서는 PyCharm > Settings)로 이동합니다.
  2. AI Assistant 설정 접근:
    • Settings 메뉴에서 Tools > AI Assistant > Model Context Protocol (MCP)로 이동합니다.
  3. MCP 서버 추가:
    • Model Context Protocol (MCP) 설정 페이지에서 Add 버튼을 클릭하여 새 MCP 서버 구성을 추가합니다.
  4. JSON 설정 입력:
    • New MCP Server 대화 상자가 나타나면, 연결 방식을 선택하고 MCP 서버를 시작하는 데 필요한 매개변수와 함께 JSON 구성 스니펫을 제공해야 합니다.
    • 한국투자 코딩도우미 MCP는 일반적으로 로컬에서 실행되므로, STDIO 또는 HTTP 방식 중 선택하거나, JSON 설정에 커맨드 라인을 지정할 수 있습니다.
    • JSON 설정은 대략 다음과 같은 형식입니다 (정확한 command와 args는 한국투자증권 GitHub 또는 개발자 센터의 MCP 설정 가이드를 참조해야 합니다):
    json
    {
      "mcpServers": {
        "korea-investment-mcp": {
          "command": "your-mcp-server-executable-path",
          "args": ["optional", "arguments"],
          "env": {
            "API_KEY": "<YOUR_API_KEY>",
            "API_SECRET": "<YOUR_API_SECRET>"
          }
        }
      }
    }
    
    • command와 args는 사용자가 로컬에 설치한 MCP 서버의 실행 경로 및 인수에 맞게 조정해야 합니다.
    • API 키와 같은 민감 정보는 환경 변수(env)를 사용하거나 별도의 구성 파일(mcp-config.json 등)로 분리하여 관리하는 것이 안전합니다.
  5. 작업 디렉터리 지정:
    • Working directory 필드에 MCP 서버가 실행될 경로를 지정합니다.
  6. 설정 저장 및 파이참 재시작:
    • OK를 클릭하여 설정을 저장하고, Apply를 클릭합니다.
    • 때로는 변경 사항을 완전히 적용하기 위해 파이참을 재시작해야 할 수도 있습니다. 
사용 방법
설정이 완료되면, 파이참의 AI Assistant 채팅 창에 / 명령어를 입력하여 등록된 한국투자 코딩도우미 MCP를 활성화하고 사용할 수 있습니다. 자연어 프롬프트를 통해 원하는 API 호출 예제 코드를 요청할 수 있습니다 (예: "삼성전자 현재가 조회하는 코드 짜줘"). 
더 자세한 기술적 사항은 한국투자증권 오픈 API 개발자 센터의 도구 및 샘플 페이지나 GitHub 저장소를 확인해 보시는 것을 권장합니다.