DexScreener MCP Server

DexScreener MCP 服务

一个用于访问 DexScreener API 的 MCP 服务实现，提供对多个区块链上 DEX 交易对数据、代币信息和市场统计数据的实时访问。

一行命令安装（自动添加到 Claude Desktop）：

curl -L https://raw.githubusercontent.com/opensvm/dexscreener-mcp-server/main/install.sh | bash

功能

• 带速率限制的 API 访问（遵守 DexScreener 的速率限制）
• 全面的错误处理
• 类型安全的接口
• 支持所有 DexScreener API 端点
• 集成测试

安装

手动安装：

npm install
npm run build
npm run setup

测试

npm test

用法

可用工具

1. get_latest_token_profiles

   • 获取最新的代币资料
   • 无需参数

   const result = await mcpClient.callTool('dexscreener', 'get_latest_token_profiles');
   

2. get_latest_boosted_tokens

   • 获取最新的推广代币
   • 无需参数

   const result = await mcpClient.callTool('dexscreener', 'get_latest_boosted_tokens');
   

3. get_top_boosted_tokens

   • 获取推广最活跃的代币
   • 无需参数

   const result = await mcpClient.callTool('dexscreener', 'get_top_boosted_tokens');
   

4. get_token_orders

   • 查看为特定代币支付的订单

   const result = await mcpClient.callTool('dexscreener', 'get_token_orders', {
     chainId: 'solana',
     tokenAddress: 'So11111111111111111111111111111111111111112'
   });
   

5. get_pairs_by_chain_and_address

   • 按链和交易对地址获取一个或多个交易对

   const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_chain_and_address', {
     chainId: 'solana',
     pairId: 'HxFLKUAmAMLz1jtT3hbvCMELwH5H9tpM2QugP8sKyfhc'
   });
   

6. get_pairs_by_token_addresses

   • 按代币地址获取一个或多个交易对（最多 30 个）

   const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_token_addresses', {
     tokenAddresses: 'So11111111111111111111111111111111111111112'
   });
   

7. search_pairs

   • 搜索匹配查询的交易对

   const result = await mcpClient.callTool('dexscreener', 'search_pairs', {
     query: 'SOL'
   });
   

速率限制

该服务实现了速率限制，以遵守 DexScreener 的 API 限制：

• Token Profile/Boost 端点：每分钟 60 次请求
• DEX/Pairs 端点：每分钟 300 次请求

错误处理

该服务处理各种错误场景：

• 超出速率限制
• 无效参数
• 网络错误
• API 错误

错误以标准化格式返回，并带有相应的错误代码和消息。

API 文档

有关详细的 API 文档，请参阅 docs/api-reference.md。

开发

项目结构

.
├── src/
│   ├── types/           # TypeScript interfaces and types
│   ├── services/        # API service implementations
│   ├── tests/           # Integration tests
│   └── index.ts         # Main server implementation
├── scripts/            # Setup and utility scripts
├── docs/              # Documentation
└── README.md          # This file

添加新功能

1. 在 src/types/ 中定义类型
2. 在 src/services/ 中实现服务方法
3. 在 src/index.ts 中添加工具处理程序
4. 更新文档
5. 添加测试

许可证

MIT