DexPaprika

Máy chủ MCP DexPaprika

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) cung cấp quyền truy cập theo yêu cầu vào API dữ liệu tiền điện tử và DEX của DexPaprika. Được xây dựng đặc biệt cho các trợ lý AI như Claude để tìm nạp dữ liệu token, pool và DEX hiện tại theo chương trình mà không cần cấu hình.

Tóm tắt nhanh

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

DexPaprika MCP kết nối Claude với dữ liệu DEX trực tiếp trên nhiều blockchain. Gói miễn phí không cần khóa API để bắt đầu. Cài đặt | Cấu hình | Tài liệu tham khảo API

Muốn không cần thiết lập? Sử dụng máy chủ MCP được lưu trữ tại mcp.dexpaprika.com: không cần cài đặt, không cần khóa để bắt đầu, các công cụ dữ liệu tương tự cộng với submitFeedback. Xem Máy chủ được lưu trữ để biết các điểm cuối truyền tải.

Bản phát hành mới nhất

Xem CHANGELOG.md để biết ghi chú phát hành và hướng dẫn di chuyển.

Bạn Có Thể Xây Dựng Gì?

• Công cụ phân tích token: Theo dõi biến động giá, thay đổi độ sâu thanh khoản và mô hình khối lượng
• So sánh DEX: Phân tích cấu trúc phí, khối lượng và các pool khả dụng trên các DEX khác nhau
• Phân tích pool thanh khoản: Theo dõi thay đổi TVL, tính toán tổn thất tạm thời và đánh giá tác động giá
• Phân tích thị trường: So sánh token xuyên chuỗi, xu hướng khối lượng và số liệu hoạt động giao dịch
• Trình theo dõi danh mục đầu tư: Theo dõi giá trị hiện tại, phân tích hiệu suất lịch sử, cơ hội lợi suất
• Phân tích kỹ thuật: Thực hiện phân tích kỹ thuật nâng cao bằng dữ liệu OHLCV lịch sử, bao gồm xác định xu hướng, nhận dạng mẫu hình và tính toán chỉ báo

Cài đặt

Cài đặt qua Smithery

Để cài đặt DexPaprika cho Claude Desktop tự động qua Smithery:

npx -y smithery mcp add coinpaprika/dexpaprika

Cài đặt thủ công

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

Đây là máy chủ stdio: nó giao tiếp MCP qua stdin và stdout và không ràng buộc cổng. Khi khởi động, nó ghi DexPaprika MCP server v<version> (tool contract v<contract>) is running... vào stderr rồi chờ máy khách. Chạy nó từ máy khách MCP (Claude Desktop, Cursor, Claude Code) thay vì mong đợi một URL trong trình duyệt.

Video hướng dẫn

Xem hướng dẫn từng bước của chúng tôi về cách thiết lập và sử dụng máy chủ MCP DexPaprika:

Tích hợp Claude Desktop

Thêm nội dung sau vào tệp cấu hình Claude Desktop của bạn:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"]
    }
  }
}

Sau khi khởi động lại Claude Desktop, các công cụ DexPaprika sẽ tự động có sẵn cho Claude.

Tùy chọn: sử dụng khóa API

Điều này hoạt động mà không cần khóa và sẽ luôn như vậy. Không cần đăng ký, không cần thẻ, không cần cấu hình gì. Mọi thứ ở trên là cách được hỗ trợ để chạy nó.

Khóa miễn phí tăng hạn mức hàng tháng và mở khóa phát trực tuyến trên bất kỳ token nào thay vì bộ trưng bày công khai. Nó không tăng giới hạn yêu cầu mỗi phút, giống nhau trên cả hai gói. Nhận khóa tại console.dexpaprika.com; giới hạn hiện tại nằm trên trang giới hạn tốc độ.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

Khóa tự điền. Không có tiền tố Bearer, và cũng không có từ lược đồ nào khác. Dán khóa chính xác như được cấp. Hầu hết mọi API khác đều yêu cầu điều ngược lại, vì vậy đây là lý do phổ biến nhất khiến một khóa hoạt động trông có vẻ bị hỏng.

Hai điều đáng biết:

• Khóa chúng tôi không đọc được không tạo ra lỗi. Các điểm cuối dữ liệu bỏ qua khóa không đọc được và phục vụ bạn như người gọi ẩn danh, với 200 bình thường và dữ liệu thực, vì vậy lỗi chính tả trông giống hệt thành công. Yêu cầu trợ lý chạy getKeyStatus sau khi đặt khóa: nó báo cáo gói mà API thực sự thấy và nêu nguyên nhân có khả năng khi khóa không được áp dụng.
• Khách hàng Pro cũng đặt DEXPAPRIKA_API_BASE_URL thành https://api-pro.dexpaprika.com. Máy chủ không tự động thay đổi, vì gửi khóa miễn phí đến máy chủ đó trả về 403.

Máy chủ được lưu trữ (không cần cài đặt)

Nếu bạn muốn không cần thiết lập, hãy trỏ bất kỳ máy khách tương thích MCP nào trực tiếp đến máy chủ được lưu trữ tại mcp.dexpaprika.com. Trang đích cung cấp hướng dẫn thiết lập và tài liệu. Các điểm cuối truyền tải sau có sẵn:

Truyền tải	Điểm cuối	Trường hợp sử dụng
HTTP có thể phát trực tuyến	https://mcp.dexpaprika.com/streamable-http	Được khuyến nghị cho hầu hết máy khách
SSE	https://mcp.dexpaprika.com/sse	Truyền tải SSE kế thừa
JSON-RPC	https://mcp.dexpaprika.com/json-rpc	JSON-RPC trực tiếp

Lưu ý: Đây là các điểm cuối giao thức MCP. Chúng sẽ không hiển thị gì trong trình duyệt. Truy cập mcp.dexpaprika.com để xem trang đích.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Các công cụ có sẵn (17)

Bản dựng tự lưu trữ này đăng ký 17 công cụ đọc: 16 công cụ dữ liệu thị trường cộng với getKeyStatus. Máy chủ được lưu trữ tại mcp.dexpaprika.com đăng ký bộ công cụ riêng bao gồm submitFeedback. Xác minh cả hai bằng tools/list trực tiếp.

Khám phá

Công cụ	Mô tả
getCapabilities	Khả năng máy chủ, mẫu quy trình làm việc, từ đồng nghĩa mạng và phương pháp hay nhất. Bắt đầu tại đây.
getNetworks	Liệt kê mọi mạng blockchain được hỗ trợ (36)
getStats	Thống kê hệ sinh thái cấp cao (tổng mạng, DEX, pool, token)
search	Tìm kiếm token, pool và DEX trên TẤT CẢ các mạng theo tên, ký hiệu hoặc địa chỉ
getKeyStatus	Liệu khóa có được gửi không và gói nào API thấy. Không đọc dữ liệu thị trường.

Hoạt động DEX

Công cụ	Mô tả	Tham số bắt buộc
getNetworkDexes	Liệt kê DEX trên một mạng cụ thể	network

Hoạt động Pool

Công cụ	Mô tả	Tham số bắt buộc
getNetworkPools	CHÍNH. Lấy các pool thanh khoản hàng đầu trên một mạng	network
getDexPools	Lấy các pool từ một DEX cụ thể (các hàng dưới results, phân trang con trỏ)	network, dex
getNetworkPoolsFilter	Lọc pool theo khối lượng, giao dịch, thời gian tạo	network
getPoolDetails	Thông tin pool chi tiết (giá, khối lượng, TVL, token)	network, pool_address
getPoolOHLCV	Dữ liệu nến OHLCV lịch sử	network, pool_address, start
getPoolTransactions	Giao dịch/giao dịch mua bán gần đây cho một pool	network, pool_address

Hoạt động Token

Công cụ	Mô tả	Tham số bắt buộc
getTokenDetails	Thông tin token chi tiết	network, token_address
getTokenPools	Các pool thanh khoản chứa một token (bộ lọc theo phạm vi mạng, results + phân trang con trỏ)	network, token_address
getTokenMultiPrices	Giá theo lô cho tối đa 10 token	network, tokens[]
getTopTokens	Token hàng đầu trên một mạng được xếp hạng theo khối lượng, thanh khoản, FDV hoặc thay đổi giá 24 giờ	network
filterNetworkTokens	Lọc token theo khối lượng, thanh khoản, FDV, giao dịch và thời gian tạo	network

Ví dụ sử dụng

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: 1710806400,
  sort_by: "volume_usd_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "2023-01-01",
  interval: "24h",
  limit: 30
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Mẫu lời nhắc cho Claude

• "Phân tích token JUP trên Solana. Tìm nạp giá, khối lượng và các pool thanh khoản hàng đầu."
• "So sánh khối lượng giao dịch giữa Uniswap V3 và SushiSwap trên Ethereum."
• "Lấy dữ liệu OHLCV 7 ngày cho SOL/USDC trên Raydium và vẽ biểu đồ giá."
• "Tìm 5 pool hàng đầu theo thanh khoản trên mạng Fantom và phân tích cấu trúc phí của chúng."
• "Lấy các giao dịch gần đây cho pool ETH/USDT trên Uniswap và phân tích áp lực mua so với bán."
• "Hiển thị cho tôi 10 pool hàng đầu trên Ethereum theo khối lượng 24 giờ."
• "Tìm kiếm tất cả các pool chứa token ARB và xếp hạng chúng theo khối lượng."
• "Lọc các pool Ethereum có khối lượng 24 giờ >100K đô la được tạo trong tuần qua."
• "Đầu tiên lấy tất cả các mạng có sẵn, sau đó hiển thị cho tôi các pool hàng đầu trên mỗi mạng chính."

Giới hạn tốc độ & hiệu suất

• Gói miễn phí: không cần khóa, không cần đăng ký, ở mức 30 yêu cầu mỗi phút. Khóa API miễn phí tăng hạn mức hàng tháng và mở khóa phát trực tuyến. Pro là 99 đô la/tháng ở mức 300 yêu cầu mỗi phút. Một yêu cầu tốn một tín dụng; các điểm cuối theo lô tốn một tín dụng cho mỗi mục. Hạn mức hàng tháng thay đổi, vì vậy hãy đọc chúng tại đây thay vì từ trang này: https://dexpaprika.com/api/pricing
• Độ trễ dữ liệu: tối đa 15 giây trên gói miễn phí, thời gian thực trên Pro
• Thời gian phản hồi: 100-500ms cho hầu hết các điểm cuối (phụ thuộc vào mạng)
• Xử lý lỗi: Lỗi có cấu trúc với mã, gợi ý và hướng dẫn thử lại
• Khả dụng dữ liệu OHLCV: Dữ liệu lịch sử thường có sẵn từ ngày tạo token/pool

Khắc phục sự cố

Các vấn đề phổ biến:

• Giới hạn tốc độ: Nếu nhận lỗi DP429_RATE_LIMIT, hãy triển khai backoff theo cấp số nhân
• Thiếu dữ liệu: Một số token/pool mới hơn có thể có dữ liệu lịch sử không đầy đủ
• Lỗi hết thời gian: Các yêu cầu dữ liệu lớn có thể mất nhiều thời gian hơn, hãy cân nhắc phân trang
• Lỗi mạng: Kiểm tra kết nối mạng, dịch vụ yêu cầu truy cập internet
• Giới hạn OHLCV: Phạm vi tối đa giữa ngày bắt đầu và ngày kết thúc là 1 năm; sử dụng phân trang cho khung thời gian dài hơn
• OHLCV trống: Pool có thể quá mới. Sử dụng getPoolTransactions thay thế

Phát triển

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

Nhật ký thay đổi

Xem CHANGELOG.md để biết ghi chú phát hành chi tiết và hướng dẫn di chuyển.

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT - xem tệp LICENSE để biết chi tiết.

Tài nguyên bổ sung

• Tài liệu API DexPaprika
• Máy chủ MCP được lưu trữ, tùy chọn không cần thiết lập
• Đặc tả Giao thức Ngữ cảnh Mô hình
• DexPaprika - Dữ liệu thị trường phân tích onchain toàn diện
• CoinPaprika - Dữ liệu thị trường tiền điện tử toàn diện