🌊 SEI区块链MCP服务器v0.1
用于SEI区块链和DragonSwap V2 DEX操作的生产就绪模型上下文协议（MCP）服务器
特性 • 快速开始 • API • 工具 • 例子 • 提示 • 安全
______________________________________________________________________
🚀 特性
🎯 完成SEI和DragonSwap集成
- 完全支持SEI区块链（EVM兼容链）
- DragonSwap V2集中流动性DEX集成
- 原生SEI包装/解包装（SEI）↔ WSEI）
- 自动多跳路由以获得最佳速率
- SEI网络上的天然气优化交易
- 支持所有主要SEI代币
🧠 智能交易引擎
- 需要时自动进行本地SEI包装
- 通过多个DEX池进行智能路由
- 自动滑动调整（1%→2%）
- 实时价格反馈和报价
- 执行前的交易模拟
- 价格影响计算
🤖 MCP协议实现
- 15+区块链自动化专用工具
- 与Claude Desktop和AI助手兼容
- HTTP REST API支持
- 使用私钥实时执行交易
- 全面的错误处理
- 针对LLM优化的结构化响应
🏛️ 企业就绪架构
- 使用Express.js构建可扩展性
- Ethers.js v5用于区块链交互
- 用于输入验证的Zod模式
- Docker容器化支持
- 综合录井
- 生产测试组件
______________________________________________________________________
📦 快速开始
✅ 先决条件
# Required
Node.js >= 18.0.0
npm >= 9.0.0
# Required for transactions
Private key for SEI wallet📥 安装
# Clone the repository
git clone https://github.com/tairon-ai/sei-mcp.git
cd sei-mcp/mcp-server
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your configuration
# Start the server
npm start
# Development mode
npm run dev
# MCP stdio server for Claude Desktop
npm run mcp🤖 Claude桌面集成
添加到您的Claude Desktop配置中：
{
"mcpServers": {
"sei-blockchain": {
"command": "node",
"args": ["/path/to/sei-mcp/mcp-server/mcp/index.js"],
"env": {
"SEI_RPC_URL": "https://evm-rpc.sei-apis.com",
"WALLET_PRIVATE_KEY": "your_private_key_without_0x"
}
}
}
}______________________________________________________________________
🛠 可用工具
🏦 区块链和DEX运营
| 工具 | 说明 | 参数 |
|---|---|---|
getServiceInfo | 获取服务器功能和配置 | - |
getWalletBalances | 获取SEI和代币的钱包余额 | address |
getNativeBalance | 获取本地SEI余额 | address |
getBlockNumber | 获取当前区块号 | - |
getGasPrice | 获取当前天然气价格 | - |
estimateGas | 估算交易用气 | to, value, data |
getTransactionStatus | 通过哈希值获取交易状态 | txHash |
convertAddress | 在Cosmos与EVM地址之间进行转换 | address, toFormat |
getTokenPrice | 获取代币价格（美元） | token |
sendNativeSEI | 发送本地SEI | to, amount |
sendToken | 发送ERC20代币 | token, to, amount |
getDragonSwapQuote | 从DragonSwap获取掉期报价 | tokenIn, tokenOut, amountIn, fee |
getDragonSwapMultiHopQuote | 获取多跳掉期报价 | path, fees, amountIn |
getDragonSwapPoolInfo | 获取池信息 | tokenA, tokenB, fee |
getDragonSwapAllPools | 列出所有可用池 | - |
executeSwap | 使用自动包装执行令牌交换 | tokenIn, tokenOut, amountIn, slippage |
______________________________________________________________________
🔗 API终点
🌐 核心终点
GET / # Server status and info
GET /health # Health check
GET /info # Service information
POST /mcp # MCP protocol endpoint______________________________________________________________________
💡 例子
💰 获取钱包余额
// Get all token balances for wallet
{
"tool": "getWalletBalances",
"params": {}
}🔄 执行掉期（本地SEI到USDC）
// Swap 5 SEI to USDC (automatic wrapping)
{
"tool": "executeSwap",
"params": {
"tokenIn": "SEI",
"tokenOut": "USDC",
"amountIn": "5"
}
}📊 获取掉期报价
// Get quote for swapping WSEI to USDT
{
"tool": "getDragonSwapQuote",
"params": {
"tokenIn": "WSEI",
"tokenOut": "USDT",
"amountIn": "10",
"fee": 3000
}
}💸 发送本地SEI
// Send 1 SEI to address
{
"tool": "sendNativeSEI",
"params": {
"to": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7",
"amount": "1"
}
}______________________________________________________________________
🤖 提示
💬 Claude、ChatGPT或其他AI助手的示例提示
这些提示演示了如何在与AI助手集成时通过自然语言与MCP服务器交互：
💱 代币交换
"What's the current price of WSEI in USDC on DragonSwap?"
"Swap 10 SEI to USDC tokens with 1% slippage"
"Execute a swap of 100 USDC to WSEI with automatic slippage adjustment"
"Find the best route to swap 50 WSEI to USDT"
"Wrap 5 SEI to WSEI for me"
"Convert my native SEI to USDC using DragonSwap"💧 流动性管理
"What's the current pool info for WSEI/USDC pair?"
"Show me all available pools on DragonSwap"
"Get the pool information for WSEI/USDT with 0.3% fee"
"Find all pools that include WSEI token"
"What's the TVL in the WSEI/USDC 0.05% pool?"📊 市场分析
"Get a quote for swapping 100 WSEI to USDC"
"What's the price impact of swapping 1000 USDC to WSEI?"
"Show me the multi-hop quote from SEI to USDT through WSEI"
"Compare rates between different fee tiers for WSEI/USDC"
"Calculate the best path for swapping SEIYAN to USDC"💼 钱包管理
"Check my wallet balances for all SEI tokens"
"What's my native SEI balance?"
"Show me my WSEI and USDC balances"
"Send 10 SEI to address 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7"
"Transfer 100 USDC to sei1abc... address"
"What's my total portfolio value in USD on SEI?"⛽ 天然气和网络运营
"What's the current gas price on SEI network?"
"Estimate gas for sending 10 SEI"
"Get the current block number on SEI"
"Check the status of transaction 0xabc123..."
"Convert my Cosmos address sei1... to EVM format"
"Convert EVM address 0x... to Cosmos sei1... format"💰 令牌信息
"Get the current price of SEIYAN token"
"What's the price of JLY token in USD?"
"Show me information about USDC token on SEI"
"Get token price for WETH on SEI network"
"What tokens are available for trading on SEI?"🔄 高级交易
"Execute a multi-hop swap from SEI through WSEI to USDC"
"Swap native SEI to USDT with automatic wrapping"
"Perform a swap with 2% slippage fallback"
"Find and execute the best route from SEIYAN to USDC"
"Swap all my WSEI to USDC with minimal slippage"🔧 AI助手的集成技巧
在MCP服务器上使用这些提示时：
- 本地SEI自动打包 在需要进行掉期交易时，联系WSEI
- 滑动自动调节 如果第一次尝试失败，则从1%增加到2%
- 多跳路由 当不存在直接池时是自动的
- Cosmos和EVM地址 支持
- 天然气估算 对所有交易都是自动的
- 使用令牌符号 （SEI、WSEI、USDC）或运营地址
______________________________________________________________________
🧪 测试
🔍 使用cURL进行API测试
# Check server health
curl http://localhost:8080/health
# Get server info
curl http://localhost:8080/info
# Get wallet balances
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{
"tool": "getWalletBalances",
"params": {}
}'
# Execute a swap
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-d '{
"tool": "executeSwap",
"params": {
"tokenIn": "SEI",
"tokenOut": "WSEI",
"amountIn": "1"
}
}'______________________________________________________________________
🔒 安全
🔐 最佳实践
- 私钥管理：永远不要提交私钥。使用环境变量
- 交易模拟：执行前的测试操作
- 防滑保护：自动从1%调整到2%
- 天然气管理：监控天然气价格并设定合理的限制
- 访问控制：实施生产认证
- 监控：使用Seitrace跟踪所有交易
🛡️ 安全功能
- 带缓冲器的自动气体估算
- 执行前的交易模拟
- 所有掉期交易都有自动滑动保护
- 使用Zod模式进行输入验证
- 全面的错误处理
- 原生SEI自动包装
______________________________________________________________________
📊 支持的网络和代币
🌐 网络
- SEI 主网 （链ID:1329）
- RPC:
https://evm-rpc.sei-apis.com - 浏览器： Seitrace 的
🪙 关键代币
- SEI：本地令牌
- WSEI:
0xE30feDd158A2e3b13e9badaeABaFc5516e95e8C7 - 美元:
0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392 - 泰达币:
0x9151434b16b9763660705744891fA906F660EcC5 - WETH:
0x160345fC359604fC6e70E3c5fAcbdE5F7A9342d8 - 塞扬。:
0x5f0E07dFeE5832Faa00c63F2D33A0D79150E8598 - JLY:
0xDD7d5e4Ea2125d43C16eEd8f1FFeFffa2F4b4aF6
📜 关键合同
- DragonSwap路由器:
0x11DA6463D6Cb5a03411Dbf5ab6f6bc3997Ac7428 - DragonSwap工厂:
0xcca2352200a63eb0Aaba2D40BA69b1d32174F285 - WSEI合同:
0xE30feDd158A2e3b13e9badaeABaFc5516e95e8C7
______________________________________________________________________
🚀 部署
🏭 生产部署
# Start production server
NODE_ENV=production npm start
# With PM2
pm2 start server.js --name sei-mcp
# With Docker
docker build -t sei-mcp .
docker run -d -p 8080:8080 --env-file .env sei-mcp🔑 环境变量
# Required for transactions
WALLET_PRIVATE_KEY=your_private_key_without_0x
# Optional
PORT=8080
SEI_RPC_URL=https://evm-rpc.sei-apis.com
NODE_ENV=production______________________________________________________________________
📈 演出
- 响应时间：读取操作小于100ms
- 交易速度：SEI网络上约2秒
- 吞吐量：每秒100+个请求
- 气体优化：SEI费用低
- 自动包装：本地SEI→ WSEI自动处理
______________________________________________________________________
🎯 主要特点
✨ 自动原生SEI包装
当从原生SEI交换到任何ERC20令牌时，服务器会自动：
- 将SEI包裹到WSEI
- 执行交换
- 返回合并交易结果
🔄 自动滑动调整
- 从1%的滑点开始
- 如果需要，自动重试2%
- 确保交易成功
🛤️ 多跳路由
- 当不存在直接池时自动找到最佳路径
- 通过WSEI或USDT作为中介的路线
- 优化以获得最优价格
______________________________________________________________________
🤝 贡献
我们欢迎捐款！请查看我们的 贡献指南 了解详情。
# Fork and clone
git fork https://github.com/tairon-ai/sei-mcp
git clone https://github.com/tairon-ai/sei-mcp
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and test
npm test
# Commit and push
git commit -m 'feat: add amazing feature'
git push origin feature/amazing-feature
# Open Pull Request______________________________________________________________________
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
🙏 致谢
- SEI网络 -最快的区块链
- DragonSwap -在SEI上领先DEX
- 模型上下文协议 -AI集成标准
- Ethers.js -以太坊库
______________________________________________________________________
建造于 Tairon.ai 在克劳德的帮助下