MCP Jupiter

Acesse a API de swap da Jupiter na blockchain Solana.

Documentação

MCP Jupiter

Este repositório contém um servidor Model Context Protocol (MCP) que fornece ao Claude acesso à API de swap da Jupiter. O servidor permite que o Claude execute operações como obter cotações, construir transações de swap e enviar transações de swap na blockchain Solana usando a Jupiter.

Visão Geral

O servidor MCP expõe várias ferramentas ao Claude:

  • jupiter_get_quote: Obter uma cotação para troca de tokens na Jupiter
  • jupiter_build_swap_transaction: Construir uma transação de swap na Jupiter
  • jupiter_send_swap_transaction: Enviar uma transação de swap na Jupiter

Pré-requisitos

  • Node.js (v16 ou superior)
  • Aplicativo Claude Desktop

Instalação

  1. Clone este repositório:

    git clone https://github.com/dcSpark/mcp-server-jupiter.git
    cd mcp-server-jupiter
    
  2. Instale as dependências:

    npm ci
    
  3. Compile o projeto:

    npm run build
    

Instalação Global

Você também pode instalar o pacote globalmente ou usá-lo diretamente com npx:

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

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

Configuração

Configurar o Claude Desktop

Para configurar o Claude Desktop para usar este servidor MCP:

  1. Abra o Claude Desktop

  2. Navegue até o arquivo de configuração do Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  3. Adicione a configuração do servidor MCP:

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

Se você instalou o pacote globalmente ou deseja usar npx, você pode configurá-lo assim:

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

Executando Localmente

# If installed locally
node build/index.js

# If installed globally
mcp-server-jupiter

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

Uso

Após a configuração, reinicie o Claude Desktop. O Claude agora terá acesso às ferramentas de swap da Jupiter. Você pode pedir ao Claude para:

  1. Obter uma cotação para troca de tokens:

    What's the quote for swapping 1 SOL to USDC?
    
  2. Construir uma transação de swap:

    Build a swap transaction for the quote I just got.
    
  3. Enviar uma transação de swap:

    Send the swap transaction I just built.
    

O Claude usará o servidor MCP para interagir diretamente com a API de swap da Jupiter.

Desenvolvimento

Adicionando Novas Ferramentas

Para adicionar novas ferramentas ao servidor MCP:

  1. Defina a ferramenta em src/tools.ts
  2. Crie uma função de manipulação no arquivo de manipulação apropriado
  3. Adicione o manipulador ao objeto handlers em src/tools.ts

Compilação

npm run build

Licença

MIT