“TheGraph” MCP 서버는 무엇을 하나요?

TheGraph MCP 서버는 AI 에이전트와 The Graph 프로토콜의 인덱싱된 블록체인 데이터를 연결하는 통합 계층입니다. 이 서버는 서브그래프 데이터를 표준 MCP(Model Context Protocol) 도구를 통해 노출함으로써 AI 시스템이 블록체인 정보를 효과적으로 접근, 쿼리, 분석할 수 있도록 해줍니다. 어시스턴트가 서브그래프 스키마를 조회하고 GraphQL 쿼리를 실행할 수 있도록 하여, 블록체인 분석, 온체인 데이터 조회, 디파이(DeFi) 모니터링 등 개발 워크플로우를 지원합니다. 개발자와 AI 에이전트는 구조화된 블록체인 데이터를 받아 자동 분석을 수행하거나, The Graph의 분산 인덱싱 네트워크와 원활하게 상호작용하는 애플리케이션을 구축할 수 있습니다.

프롬프트 목록

• 스키마 쿼리
  • 특정 서브그래프의 스키마를 조회하거나, GraphQL 스키마를 읽기 쉽도록 요청하거나 데이터 모델 구조를 파악하는 프롬프트
• 데이터 쿼리
  • 서브그래프에서 특정 데이터를 조회하는 프롬프트(예: 거래량 상위 토큰 찾기, 유동성 높은 페어 조회, 최근 스왑 이벤트 목록 등)
• 분석 작업
  • 특정 토큰의 기간별 거래량 등 블록체인 데이터 분석을 수행하는 프롬프트

리소스 목록

저장소에 명시된 MCP 리소스가 없습니다.

도구 목록

• getSubgraphSchema
  • 지정한 서브그래프의 스키마를 가져와, AI 에이전트가 The Graph에 인덱싱된 블록체인 데이터의 구조와 형식을 이해할 수 있도록 합니다.
• querySubgraph
  • 지정한 서브그래프에 대해 GraphQL 쿼리를 실행하여, The Graph의 인덱싱된 블록체인 데이터에서 맞춤형 데이터 세트와 분석 정보를 직접 가져올 수 있습니다.

MCP 서버 활용 예시

• 블록체인 데이터 분석
  • 개발자와 AI 에이전트가 온체인 데이터(예: 거래량, 유동성 등)를 분석하여 DeFi 플랫폼 또는 트레이딩 봇에 인사이트를 제공합니다.
• 개발자를 위한 스키마 탐색
  • 서브그래프 스키마를 빠르게 조회하여 데이터 모델을 이해하고, 블록체인 연동 애플리케이션 개발을 가속화합니다.
• DeFi 모니터링 및 리포팅
  • 서브그래프 쿼리를 활용해 분산형 거래소 및 자산의 주요 지표(예: 상위 토큰, 스왑 이벤트 등)를 자동 모니터링합니다.
• 맞춤 데이터 조회
  • 맞춤형 GraphQL 쿼리를 작성·실행하여 연구, 대시보드, 실시간 분석 등에 필요한 특정 블록체인 데이터를 추출합니다.
• AI 기반 블록체인 어시스턴트
  • 이상 거래 탐지, 리포트 생성 등 블록체인 데이터 기반 질문에 답하거나 업무를 자동화하는 에이전트에 활용합니다.

설치 방법

Windsurf

1. 필수사항: Python 3.10+ 및 uv가 설치되어 있어야 합니다.
2. 저장소 클론:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. 설정 파일 수정: Windsurf 설정 파일(예: config.json)을 찾으세요.
4. TheGraph MCP 서버 추가:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. 저장 및 Windsurf 재시작
6. 확인: 스키마 또는 데이터 쿼리 프롬프트로 테스트하세요.

Claude

1. 필수사항: Python과 uv가 설치되어 있어야 합니다.
2. 저장소 클론:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Claude의 MCP 설정 업데이트: Claude 설정 파일을 수정하세요.
4. 서버 정보 입력:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Claude 재시작 후 연결 테스트

Cursor

1. 필수 소프트웨어 설치: Python 3.10+ 및 uv
2. 저장소 클론:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Cursor의 MCP 설정 파일 수정
4. 다음 JSON 추가:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Cursor 재시작 후 테스트 쿼리 실행

Cline

1. 필수사항: Python 3.10+ 및 uv가 있어야 합니다.
2. 저장소 클론:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Cline의 설정 파일 수정
4. MCP 설정에 다음 삽입:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Cline 재시작 후 프롬프트로 테스트

API 키 보안

• THEGRAPH_API_KEY는 환경변수로 저장하세요.
• 예시 설정:

  {
    "mcpServers": {
      "thegraph-mcp": {
        "command": "uv",
        "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
        "env": {
          "THEGRAPH_API_KEY": "${THEGRAPH_API_KEY}"
        }
      }
    }
  }
  

FlowHunt 플로우에서 MCP 사용하는 방법

FlowHunt에서 MCP 사용하기

MCP 서버를 FlowHunt 워크플로우에 통합하려면, 플로우에 MCP 컴포넌트를 추가 후 AI 에이전트와 연결하세요.

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 다음과 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "thegraph-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면 AI 에이전트가 이 MCP를 도구로 활용하여 모든 기능과 역량에 접근할 수 있습니다. 실제 MCP 서버 이름과 URL은 본인 환경에 맞게 “thegraph-mcp"와 URL을 변경해 주세요.

개요

의견

TheGraph MCP 서버는 The Graph의 인덱싱된 블록체인 데이터와 상호작용하기 위한 명확한 인터페이스와 두 가지 핵심 도구를 제공합니다. 설치 및 보안에 대한 문서화는 잘 되어 있지만, 명시적 MCP 리소스, 루트, 샘플링에 대한 설명은 부족합니다. 전체적으로 의도한 목적에 적합하며 간단하고 실용적입니다.

평가: 7/10

MCP 점수