Jupiter MCP Server

🚀 木星 MCP 服务器

本项目仓库包含一个模型上下文协议 (MCP) 服务器，该服务器为 Claude 提供访问 Jupiter 的交换 API。借助此服务器，Claude 能够在 Solana 区块链上使用 Jupiter 执行获取报价、构建交换事务和发送交换事务等操作，为相关业务流程提供了有力支持。

🚀 快速开始

此 MCP 服务器为 Claude 提供了一系列工具，使其能够在 Jupiter 上实现代币交换的相关操作。以下是服务器提供的主要工具：

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

✨ 主要特性

• 借助 Jupiter API（Lite API v1）执行交换，https://lite-api.jup.ag/swap/v1 提供了简化接口，可在单个请求中构建和执行交换，提升了可靠性。

📦 安装指南

从 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
   

💻 使用示例

基础用法

添加新的工具

要向 MCP 服务器添加新工具，可按以下步骤操作：

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

📚 详细文档

配置

环境变量配置

在环境变量文件（如 .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"
    }
  }
}

故障排除

若在交换执行期间遇到错误，可按以下步骤排查：

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

🔧 技术细节

此服务器使用 Jupiter API 中的 Lite API v1（https://lite-api.jup.ag/swap/v1）来执行交换操作。Lite API 提供了简化的接口，可在单个请求中完成构建和执行交换的操作，有效提高了系统的可靠性。

📄 许可证

本项目采用 MIT 许可证。