返回市场
合约筛选器-MCP服务器

合约筛选器-MCP服务器

作者:openSVM19 星标更新:2025-01-06

项目介绍

DexScreener MCP Server

这是一个用于访问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 m
    

mcpClient.callTool('dexscreener', 'get_top_boosted_tokens');


4. `get_token_orders`
- 检查特定代币的订单
```typescript
const result = await mcpClient.callTool('dexscreener', 'get_token_orders', {
  chainId: 'solana',
  tokenAddress: 'So11111111111111111111111111111111111111112'
});
  1. get_pairs_by_chain_and_address

    • 根据链和配对地址获取一个或多个配对
    const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_chain_and_address', {
      chainId: 'solana',
      pairId: 'HxFLKUAmAMLz1jtT3hbvCMELwH5H9tpM2QugP8sKyfhc'
    });
    
  2. get_pairs_by_token_addresses

    • 根据代币地址获取一个或多个配对(最多30个)
    const result = await mcpClient.callTool('dexscreener', 'get_pairs_by_token_addresses', {
      tokenAddresses: 'So11111111111111111111111111111111111111112'
    });
    
  3. 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