Jupiter MCP Server

🚀 Jupiter MCP Server

This repository contains a Model Context Protocol (MCP) server that provides Claude with access to Jupiter's swap API. This server enables Claude to perform operations such as getting quotes, building swap transactions, and sending swap transactions on the Solana blockchain using Jupiter.

🚀 Quick Start

The MCP server offers Claude the following tools to interact with Jupiter on the Solana blockchain:

• jupiter_get_quote: Obtain a quote for swapping tokens on Jupiter.
• jupiter_build_swap_transaction: Construct a swap transaction on Jupiter.
• jupiter_send_swap_transaction: Send a swap transaction on Jupiter.
• jupiter_execute_swap: Execute a complete swap using the wallet private key from environment variables.

✨ Features

• Simplified API Interaction: Utilizes Jupiter's Lite API v1 (https://lite-api.jup.ag/swap/v1) to perform swaps, offering a streamlined interface for building and executing swaps in a single request, thus enhancing reliability.

📦 Installation

From npm (Recommended)

# Install globally
npm install -g jupiter-mcp-server

# Or use phased installation
npm install --global jupiter-mcp-server

Manual Installation

1. Download the source code:

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

2. Install dependencies and build the module:

   npm install
   npm run build
   

3. Start the server:

   node dist/main.js
   

📚 Documentation

Configuration

Environment Variables Configuration

Add the following content to your environment variables file (e.g., .env):

LOG_LEVEL=info

JSON Configuration File

Create or modify the config.json file as follows:

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

Adding New Tools

To add a new tool to the MCP server:

1. Define the tool in src/tools.ts.
2. Create the corresponding handler function in the appropriate handler file.
3. Add the handler to the handlers object in src/tools.ts.

Troubleshooting

If you encounter errors during swap execution, follow these steps:

1. Set LOG_LEVEL=debug in your environment variables to get detailed logs.
2. Check if you've provided a valid Solana private key.
3. Ensure your wallet has enough SOL for swaps and transaction fees.
4. Verify that you're using the correct input and output token identifiers.

Local Development

1. Clone the repository:

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

2. Install dependencies and start the development server:

   npm install
   npm run dev
   

3. Test your changes:

   npm test
   

Publishing to npm

Log in to npm

npm login

Then publish the package:

npm publish

To publish a new version, first update the version in package.json:

npm version patch  # or minor, or major
npm publish

📄 License

This project is licensed under the MIT License.