# MCP Jupiter

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

## Overview

The MCP server exposes several tools to Claude:

- `jupiter_get_quote`: Get a quote for swapping tokens on Jupiter
- `jupiter_build_swap_transaction`: Build a swap transaction on Jupiter
- `jupiter_send_swap_transaction`: Send a swap transaction on Jupiter

## Prerequisites

- Node.js (v16 or higher)
- Claude Desktop application

## Installation

1. Clone this repository:
   ```bash
   git clone https://github.com/dcSpark/mcp-server-jupiter.git
   cd mcp-server-jupiter
   ```

2. Install dependencies:
   ```bash
   npm ci
   ```

3. Build the project:
   ```bash
   npm run build
   ```

### Global Installation

You can also install the package globally or use it directly with npx:

```bash
# Install globally
npm install -g @mcp-dockmaster/mcp-server-jupiter

# Or use directly with npx
npx @mcp-dockmaster/mcp-server-jupiter
```

## Configuration

### Configure Claude Desktop

To configure Claude Desktop to use this MCP server:

1. Open Claude Desktop
2. Navigate to the Claude Desktop configuration file:
   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
   - Linux: `~/.config/Claude/claude_desktop_config.json`

3. Add the MCP server configuration:

```json
{
  "mcpServers": {
    "mcp-server-jupiter": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-server-jupiter/build/index.js"
      ]
    }
  }
}
```

If you've installed the package globally or want to use npx, you can configure it like this:

```json
{
  "mcpServers": {
    "mcp-server-jupiter": {
      "command": "npx",
      "args": [
        "@mcp-dockmaster/mcp-server-jupiter"
      ]
    }
  }
}
```

### Running Locally

```bash
# If installed locally
node build/index.js

# If installed globally
mcp-server-jupiter

# Using npx
npx @mcp-dockmaster/mcp-server-jupiter
```

## Usage

Once configured, restart Claude Desktop. Claude will now have access to the Jupiter swap tools. You can ask Claude to:

1. Get a quote for swapping tokens:
   ```
   What's the quote for swapping 1 SOL to USDC?
   ```

2. Build a swap transaction:
   ```
   Build a swap transaction for the quote I just got.
   ```

3. Send a swap transaction:
   ```
   Send the swap transaction I just built.
   ```

Claude will use the MCP server to interact with Jupiter's swap API directly.

## Development

### Adding New Tools

To add new tools to the MCP server:

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

### Building

```bash
npm run build
```

## License

MIT