MCP 服务器

Finance MCP Server

Provides real-time financial data including exchange rates, Bitcoin prices, gold prices, and S&P 500 index via MCP tools and resources.

README

Finance MCP Server - 실시간 금융 정보 MCP 서버

MCP(Model Context Protocol)를 활용한 실시간 금융 정보 제공 서버입니다.

MCP란?

**Model Context Protocol (MCP)**는 AI 애플리케이션이 외부 데이터 소스 및 도구와 표준화된 방법으로 통신할 수 있게 하는 오픈 프로토콜입니다.

MCP 아키텍처

┌─────────────────┐          ┌─────────────────┐
│  MCP Client     │          │   MCP Server    │
│  (Claude Code)  │ ◄─────► │  (이 프로젝트)  │
│                 │  JSON-   │                 │
│                 │   RPC    │  - Resources    │
│                 │          │  - Tools        │
│                 │          │  - Prompts      │
└─────────────────┘          └─────────────────┘

제공하는 금융 정보

실시간 데이터:

💱 환율: USD/KRW (달러/원), JPY/KRW (엔/원)
₿ 비트코인: 실시간 BTC 가격 (KRW, USD)
🥇 금시세: 3.75그램 기준 금 가격
📈 S&P 500: 미국 주요 지수

데이터 소스:

환율: Open Exchange Rates API
암호화폐/금: CoinGecko API
S&P 500: Yahoo Finance

이 서버가 제공하는 기능

1. Resources (리소스)

finance://USD/KRW - 달러/원 환율
finance://JPY/KRW - 엔/원 환율
finance://BTC - 비트코인 가격
finance://GOLD - 금 시세
finance://SP500 - S&P 500 지수

2. Tools (도구)

get_exchange_rate - 특정 환율 조회
get_bitcoin_price - 비트코인 가격 조회
get_gold_price - 금 시세 조회
get_sp500 - S&P 500 지수 조회
get_all_prices - 모든 금융 정보 한번에 조회

설치 및 실행

1. 의존성 설치

npm install

2. 빌드

npm run build

3. Claude Desktop에 MCP 서버 등록

~/Library/Application Support/Claude/claude_desktop_config.json 파일을 편집:

{
  "mcpServers": {
    "finance": {
      "command": "node",
      "args": ["/Users/jongunpark/PracticeDev/testMCP/build/index.js"]
    }
  }
}

중요: 경로를 실제 프로젝트의 절대 경로로 변경하세요!

4. Claude Desktop 재시작

Claude Desktop을 재시작하면 금융 정보 MCP 서버가 연결됩니다.

사용 예시

Claude Desktop이나 Claude Code에서 다음과 같이 사용할 수 있습니다:

"현재 달러 환율 알려줘"
→ get_exchange_rate 도구 사용

"비트코인 가격은?"
→ get_bitcoin_price 도구 사용

"금시세 확인해줘"
→ get_gold_price 도구 사용

"모든 금융 정보 보여줘"
→ get_all_prices 도구 사용

코드 구조 설명

핵심 개념

실시간 데이터 fetching

// 외부 API에서 실시간 데이터 가져오기
async function getExchangeRates() {
  const response = await fetch('https://open.er-api.com/v6/latest/USD');
  const data = await response.json();
  // ...
}

MCP Tools 제공

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      {
        name: "get_bitcoin_price",
        description: "실시간 비트코인 가격을 가져옵니다",
        inputSchema: { /* ... */ }
      },
      // ...
    ]
  };
});

Tool 실행

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  switch (request.params.name) {
    case "get_bitcoin_price":
      // 비트코인 가격 조회 및 반환
      break;
    // ...
  }
});