木星 MCP 服务器

此仓库包含一个模型上下文协议 (MCP) 服务器，该服务器为 Claude 提供访问 Jupiter 的交换 API。该服务器使 Claude 能够执行诸如获取报价、构建交换事务和发送交换事务之类的操作，这些操作在 Solana 区块链上使用 Jupiter 进行。

概述

该 MCP 服务器向 Claude 提供以下工具：

• jupiter_get_quote：在 Jupiter 上获取交换代币的报价
• jupiter_build_swap_transaction：在 Jupiter 上构建交换事务
• jupiter_send_swap_transaction：在 Jupiter 上发送交换事务
• jupiter_execute_swap：使用环境变量中的钱包私钥执行完整的交换

API 实现

此服务器使用 Jupiter API：

• Lite API v1 (https://lite-api.jup.ag/swap/v1) 执行交换

Lite API 提供了一个简化的接口，用于在单个请求中构建和执行交换，从而提高了可靠性。

先决条件

• Node.js (v16 或更高版本)
• Claude Desktop 应用程序
• (可选) 一个 Solana 钱包私钥以实现自动交换执行

安装

从 npm（推荐）

# 全局安装
npm install -g jupiter-mcp-server

# 或使用分阶段安装
npm install --global jupiter-mcp-server

手动安装

1. 下载源代码：

   git clone https://github.com/yourusername/jupiter-mcp-server.git
   cd jupiter-mcp-server
   

2. 安装依赖项并构建模块：

   npm install
   npm run build
   

3. 启动服务器：

   node dist/main.js
   

配置

环境变量配置

在环境变量文件中添加以下内容（例如 .env）：

LOG_LEVEL=info

JSON 配置文件

创建或修改 config.json 文件，如下所示：

{
  "tools": {
    "jupiter_get_quote": {
      "enabled": true,
      "api_key": "your_api_key_here"
    },
    "jupiter_build_swap_transaction": {
      "enabled": true,
      "network": "mainnet-beta"
    }
  }
}

使用

添加新的工具

要向 MCP 服务器添加新工具：

1. 在 src/tools.ts 中定义工具
2. 创建相应的处理函数在适当的处理器文件中
3. 将处理器添加到 handlers 对象中，位于 src/tools.ts

故障排除

如果在交换执行期间遇到错误，请按照以下步骤进行排查：

1. 设置 LOG_LEVEL=debug 在您的环境变量中以获取详细日志
2. 检查您是否提供了有效的 Solana 私钥
3. 确保您的钱包有足够的 SOL 进行交换和交易费用
4. 验证您使用了正确的输入和输出代币标识符

开发

本地开发

1. 克隆仓库：

   git clone https://github.com/yourusername/jupiter-mcp-server.git
   cd jupiter-mcp-server
   

2. 安装依赖项并启动开发服务器：

   npm install
   npm run dev
   

3. 测试您的更改：

   npm test
   

发布到 npm

登录 npm

npm login

然后发布包：

npm publish

要发布新版本，请首先更新 package.json 中的版本：

npm version patch  # 或 minor，或 major
npm publish

许可证

MIT