TheGraph MCP Server

TheGraph MCP Server làm gì?

TheGraph MCP Server là một tầng tích hợp kết nối các tác nhân AI với dữ liệu blockchain đã lập chỉ mục từ giao thức The Graph. Nó cho phép hệ thống AI truy cập, truy vấn và phân tích thông tin blockchain một cách hiệu quả bằng cách cung cấp dữ liệu subgraph thông qua các công cụ MCP (Model Context Protocol) chuẩn hóa. Bằng cách cho phép các trợ lý truy xuất schema subgraph và thực thi các truy vấn GraphQL, TheGraph MCP Server hỗ trợ các quy trình phát triển liên quan đến phân tích blockchain, truy xuất dữ liệu on-chain và giám sát tài chính phi tập trung (DeFi). Máy chủ này giúp các nhà phát triển và tác nhân AI lấy dữ liệu blockchain có cấu trúc, thực hiện phân tích tự động và xây dựng ứng dụng tương tác liền mạch với mạng lập chỉ mục phi tập trung của The Graph.

Danh sách Prompts

• Truy vấn Schema
  • Prompts để lấy và hiển thị schema của một subgraph cụ thể, ví dụ như yêu cầu schema GraphQL có thể đọc được hoặc hiểu cấu trúc mô hình dữ liệu.
• Truy vấn Dữ liệu
  • Prompts để lấy dữ liệu cụ thể từ một subgraph, như tìm các token có khối lượng giao dịch lớn nhất, truy xuất các cặp có thanh khoản cao hoặc liệt kê các sự kiện swap gần đây.
• Nhiệm vụ Phân tích
  • Prompts để thực hiện phân tích trên dữ liệu blockchain, ví dụ như phân tích khối lượng giao dịch của một token cụ thể trong một khoảng thời gian xác định.

Danh sách Tài nguyên

Không có tài nguyên MCP cụ thể nào được ghi lại trong repository.

Danh sách Công cụ

• getSubgraphSchema
  • Lấy schema của một subgraph cụ thể, cho phép tác nhân AI hiểu cấu trúc và định dạng dữ liệu blockchain đã được The Graph lập chỉ mục.
• querySubgraph
  • Thực thi các truy vấn GraphQL trên subgraph được chỉ định, cho phép truy xuất các bộ dữ liệu và phân tích tùy chỉnh trực tiếp từ dữ liệu blockchain đã lập chỉ mục của The Graph.

Trường hợp sử dụng của MCP Server này

• Phân tích dữ liệu Blockchain
  • Nhà phát triển và tác nhân AI có thể phân tích dữ liệu on-chain như khối lượng giao dịch hoặc thanh khoản, cung cấp insight cho các nền tảng DeFi hoặc bot giao dịch.
• Khám phá Schema cho Nhà phát triển
  • Cho phép truy xuất nhanh schema của subgraph để hiểu mô hình dữ liệu, tăng tốc phát triển ứng dụng tích hợp blockchain.
• Giám sát và Báo cáo DeFi
  • Giám sát tự động các chỉ số tài chính (ví dụ: token hàng đầu, sự kiện swap) cho các sàn giao dịch phi tập trung và tài sản bằng truy vấn subgraph.
• Truy xuất Dữ liệu Tùy chỉnh
  • Hỗ trợ trích xuất các dữ liệu blockchain cụ thể cho nghiên cứu, dashboard, hoặc phân tích thời gian thực bằng cách xây dựng và thực thi truy vấn GraphQL tùy chỉnh.
• Trợ lý Blockchain tích hợp AI
  • Cung cấp sức mạnh cho các tác nhân có thể trả lời câu hỏi hoặc tự động hóa nhiệm vụ dựa trên dữ liệu blockchain, như cảnh báo giao dịch bất thường hoặc tạo báo cáo.

Hướng dẫn cài đặt

Windsurf

1. Yêu cầu: Đảm bảo đã cài đặt Python 3.10+ và uv.
2. Clone repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Chỉnh sửa file cấu hình: Xác định file cấu hình Windsurf của bạn (ví dụ: config.json).
4. Thêm TheGraph MCP Server:

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

5. Lưu và khởi động lại Windsurf.
6. Kiểm tra: Thử với một prompt truy vấn schema hoặc dữ liệu.

Claude

1. Yêu cầu: Đã cài đặt Python và uv.
2. Clone repo:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Cập nhật cấu hình MCP của Claude: Chỉnh sửa file config của Claude.
4. Chèn thông tin server:

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

5. Khởi động lại Claude và kiểm tra kết nối.

Cursor

1. Cài đặt yêu cầu: Python 3.10+ và uv.
2. Clone repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Chỉnh sửa file MCP config của Cursor.
4. Thêm JSON sau vào cấu hình:

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

5. Khởi động lại Cursor và kiểm tra bằng một truy vấn thử.

Cline

1. Yêu cầu: Đảm bảo đã có Python 3.10+ và uv.
2. Clone repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Chỉnh sửa file cấu hình của Cline.
4. Thêm cấu hình sau vào MCP config:

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

5. Khởi động lại Cline, sau đó kiểm tra với một prompt.

Bảo mật API Key

• Lưu THEGRAPH_API_KEY của bạn dưới dạng biến môi trường.
• Ví dụ cấu hình:

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

Cách sử dụng MCP này trong flows

Sử dụng MCP trong FlowHunt

Để tích hợp MCP server vào workflow của bạn trên FlowHunt, bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với tác nhân AI của bạn:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong mục cấu hình MCP hệ thống, chèn thông tin server MCP của bạn theo định dạng JSON sau:

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

Sau khi cấu hình, tác nhân AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng của nó. Lưu ý đổi “thegraph-mcp” thành tên thực tế của MCP server của bạn và thay URL bằng địa chỉ MCP server riêng.

Tổng quan

Nhận xét của chúng tôi

TheGraph MCP Server cung cấp giao diện rõ ràng và hai công cụ thiết yếu để tương tác với dữ liệu blockchain đã lập chỉ mục từ The Graph. Tài liệu hướng dẫn cài đặt và bảo mật đầy đủ, nhưng thiếu chi tiết về tài nguyên MCP cụ thể, roots hoặc sampling. Tổng thể, sản phẩm dễ sử dụng và đáp ứng tốt mục tiêu đề ra.

Đánh giá: 7/10

Điểm MCP