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 的 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

📄 許可證

本項目採用 MIT 許可證。