使用说明

Xeenon令牌MCP服务器

该项目实现了 MCP服务器为了 Xeenon代币计划在索拉纳。它既是一个功能齐全的MCP服务器，用于和Xeenon令牌程序交互，也是一个演示如何以编程方式和它交互的示例。

需求

Node.js：18.0.0或更高版本
Solana钱包：用于交易签名的私钥
Xeenon API密钥：访问Xeenon令牌数据所需
RPC终结点：Solana RPC URL（主网或开发网）

环境变量

MCP服务器正常运行需要以下环境变量：

变量	必填	默认	描述
`XEENON_API_KEY`	✅	`xeen_`	用于访问令牌数据的Xeenon API密钥。首选 https://xeenon.xyz 得到一个。
`SOLANA_PRIVATE_KEY`	✅	`[]`	用于签署交易的Solana钱包私钥
`RPC_URL`	✅	`https://api.mainnet-beta.solana.com`	Solana RPC端点URL
`XEENON_API_URL`	❌	`https://main.public-api.xeenon.xyz`	Xeenon API基础URL
`CREDIEZ_ADDRESS`	❌	`ViSmGbBJNTSMczzEqPU2ijmAqpstphkBuM9SoYCredz`	信用代币作为地址
`MAYFLOWER_PROGRAM_ID`	❌	`MMkP6WPG4ySTudigPQpKNpranEYBzYRDe8Ua7Dx89Rk`	五月花计划ID
`XEENON_PROGRAM_ID`	❌	`XEENqbVXt8y94cH7WMwYyQSuDgkvzZTzEzpsWLZu7Jf`	Xeenon程序ID
`TENANT_ADDRESS`	❌	`655W5GfTcnAtUkietVLonp89xtCFPfWx6GzFTcXTfp4r`	Xeenon运营的租户地址

私钥格式

这 SOLANA_PRIVATE_KEY 环境变量支持多种格式：

JSON数组: [123,45,67,89,...] （64个数字，0-255）
基地58: 3QqJ7s8KxC2BvF9G... （87-88个字符）
种子短语: "word1 word2 word3..." （12或24字）
十六进制字符: a1b2c3d4e5f6... （64或128个字符）
逗号分隔: 123,45,67,... （无括号）

获取API密钥

要获得Xeenon API密钥：

访问 https://xeenon.xyz
注册或登录您的帐户
导航到API部分
生成新的API密钥（格式： xeen_...)

安装

1.将MCP配置添加到您的客户端：

使用npm：

光标和克劳德：

将以下内容添加到您的 .cursor/mcp.json 或 claude_desktop_config.json （MacOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "xeenon-tokens-mcp-server": {
      "command": "npx",
      "args": ["-y", "@graviton-inc/xeenon-tokens-mcp-server@latest"],
      "env": {
        "RPC_URL": "https://api.mainnet-beta.solana.com",
        "SOLANA_PRIVATE_KEY": "[1,2,3,4,5,6,7,8,9,10]",
        "XEENON_API_KEY": "xeen_abcdef"
      },
      "toolCallTimeoutMillis": 120000
    }
  }
}

泽德

将以下内容添加到您的 settings.json

{
  "context_servers": {
    "xeenon-tokens-mcp-server": {
      "command": {
        "path": "npx",
        "args": ["-y", "@graviton-inc/xeenon-tokens-mcp-server@latest"],
        "env": {
          "RPC_URL": "https://api.mainnet-beta.solana.com",
          "SOLANA_PRIVATE_KEY": "[1,2,3,4,5,6,7,8,9,10]",
          "XEENON_API_KEY": "xeen_abcdef"
        }
      },
      "settings": {}
    }
  }
}

使用Docker：

使用Docker运行MCP服务器有两种选择：

选项1：使用官方Docker Hub镜像：

将以下内容添加到您的 .cursor/mcp.json 或 claude_desktop_config.json:

{
  "mcpServers": {
    "xeenon-tokens-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "RPC_URL",
        "-e", "SOLANA_PRIVATE_KEY",
        "gravitonxyz/xeenon-tokens-mcp-server"
      ],
      "env": {
        "RPC_URL": "https://api.mainnet-beta.solana.com",
        "SOLANA_PRIVATE_KEY": "[1,2,3,4,5,6,7,8,9,10]",
        "XEENON_API_KEY": "xeen_abcdef"
      },
      "toolCallTimeoutMillis": 120000
    }
  }
}

这种方法：

使用官方Docker Hub镜像
通过环境变量正确处理JSON转义
提供更可靠的配置方法

选项2：在本地构建Docker镜像：

您还可以在本地构建和运行Docker镜像。首先，构建Docker镜像：

docker-compose build

然后，将以下内容添加到您的 .cursor/mcp.json 或 claude_desktop_config.json:

{
  "mcpServers": {
    "xeenon-tokens-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "RPC_URL=https://api.mainnet-beta.solana.com",
        "SOLANA_PRIVATE_KEY=[1,2,3,4,5,6,7,8,9,10]",
        "XEENON_API_KEY=xeen_abcdef",
        "gravitonxyz/xeenon-tokens-mcp-server"
      ]
    },
    "toolCallTimeoutMillis": 120000
  }
}

通过Smithery安装

通过以下方式自动安装克劳德桌面的Xeenon令牌MCP服务器史密瑟里:

npx -y @smithery/cli install @GravitonINC/xeenon-tokens-mcp-server --client claude

例子

以下是您可以使用MCP服务器执行的一些示例操作：

1.获取令牌详细信息

// Get information about a Xeenon token
getTokenDetailsByAddressOrSymbol({
  tokenAddressOrSymbol: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN"
})

2.报价和购买代币

// Get a quote for buying tokens with CREDIEZ
quoteBuy({
  crediezAmount: 1000,
  token: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN"
})

// Buy tokens with exact CREDIEZ amount
buy({
  crediezAmount: 1000,
  token: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN",
  minOutAmount: 0  // Optional slippage protection
})

3.岗位管理

// Deposit tokens into a position
deposit({
  amount: 500,
  token: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN"
})

// Borrow CREDIEZ against your position
borrow({
  borrowAmount: 100,
  token: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN"
})

// Repay your CREDIEZ loan
repay({
  repayAmount: 50,
  token: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN"
})

4.流动性操作

// Donate CREDIEZ to a token's liquidity pool
donateLiquidity({
  amount: 100,
  token: "UPh8qUNj3p5NSN4fTdHX1kubBSQph4PwxBZdV44XEEN"
})

故障排除

常见问题

1.“未设置环境变量SOLANA_PRIVATE_KEY”

确保您的私钥在环境变量中设置正确
检查您的私钥格式是否受支持（请参阅上面的私钥格式）

2.“无法检测密钥对格式”

验证您的私钥是否采用支持的格式之一
删除任何多余的空格或字符
对于JSON数组，确保所有64个数字都在0到255之间

3.“资金不足”错误

检查您的CREDIEZ余额以进行购买/还款操作
验证您是否有足够的SOL支付交易费用
确保您有出售/存款所需的代币余额

4.“交易失败”或超时错误

尝试使用不同的RPC端点（Helius、QuickNode等）
增加 toolCallTimeoutMillis 在MCP配置中
在以下位置检查Solana网络状态 status.solana.com

5.“无效的API密钥”错误

验证您的 XEENON_API_KEY 以...开始 xeen_
确保API密钥处于活动状态并且尚未过期
检查您的环境是否使用了正确的API密钥

调试模式

要启用调试日志记录，您可以使用其他环境变量运行服务器：

DEBUG=1 npm run dev

发展

构建

npm run build

执行

npx -y --prefix /path/to/local/xeenon-tokens-mcp-server @graviton-inc/xeenon-tokens-mcp-server

发布

npm publish --access public

支持的工具

操作	已实施	描述	要求
getTokenDetails ByAddressOrSymbol	✅	通过地址或符号获取Xeenon代币的详细信息	API密钥
quoteBuy	✅	获取购买具有确切现金金额的代币的报价	API密钥，RPC
购买	✅	购买具有确切现金金额的代币	API密钥、私钥、RPC、CREDIEZ余额
quoteSell	✅	获取具有确切代币金额的代币销售报价	API密钥，RPC
出售	✅	出售具有确切代币数量的代币	API密钥、私钥、RPC、代币余额
押金✅	将代币存入仓位	API密钥、私钥、RPC、代币余额
撤回	✅	从仓位提取代币	API密钥、私钥、RPC、仓位余额
借用	✅	针对已存入代币借用CREDIEZ	API密钥、私钥、RPC、头寸余额
偿还	✅	偿还CREDIEZ贷款	API密钥，私钥，RPC，CREDIEZ余额，贷款余额
捐赠流动性	✅	向流动性池捐赠代币	API密钥、私钥、RPC、CREDIEZ余额

网络支持

此MCP服务器同时支持 索拉纳主网 和 国际信息发展组织:

主网：使用 https://main.public-api.xeenon.xyz 用于生产操作
国际信息发展组织：使用 https://dev.public-api.xeenon.xyz 用于测试（需要devnet令牌）

为了获得更好的性能和可靠性，请考虑使用专用的RPC提供程序，例如：

安全说明

从不提交私钥 到版本控制
使用环境变量或安全密钥管理系统
考虑使用专用钱包进行自动化操作
监控您钱包的SOL余额以获取交易费用
定期轮换API密钥以增强安全性