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 限制：

• 代币概况/推广端点：每分钟 60 个请求
• DEX/交易对端点：每分钟 300 个请求

错误处理

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

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

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

API 文档

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

开发

项目结构

.
├── src/
│   ├── types/           # TypeScript 接口和类型
│   ├── services/        # API 服务实现
│   ├── tests/           # 集成测试
│   └── index.ts         # 主要服务器实现
├── scripts/            # 设置和实用程序脚本
├── docs/              # 文档
└── README.md          # 此文件

添加新功能

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

许可证

MIT