Solana Agent Kit MCP Server

Interaja com a blockchain Solana usando o Solana Agent Kit.

Documentação

Servidor MCP do Solana Agent Kit

Um servidor Model Context Protocol (MCP) que fornece ferramentas onchain para o Claude AI, permitindo que ele interaja com a blockchain Solana por meio de uma interface padronizada. Esta implementação é baseada no Solana Agent Kit e permite que agentes de IA executem operações de blockchain de forma integrada.

Visão Geral

Este servidor MCP estende as capacidades do Claude fornecendo ferramentas para:

Interagir com a blockchain Solana
Executar transações
Consultar informações de contas
Gerenciar carteiras Solana

O servidor implementa a especificação Model Context Protocol para padronizar interações com blockchain para agentes de IA.

Pré-requisitos

Node.js (v16 ou superior)
pnpm (recomendado), npm ou yarn
Carteira Solana com chave privada
URL RPC da Solana (mainnet, testnet ou devnet)

Instalação

Opção 1: Instalação Rápida (Recomendada)

# Download the installation script
curl -fsSL https://raw.githubusercontent.com/sendaifun/solana-mcp/main/scripts/install.sh -o solana-mcp-install.sh

# Make it executable and run
chmod +x solana-mcp-install.sh && ./solana-mcp-install.sh --backup

Isso iniciará um processo de instalação interativo que irá guiá-lo por:

Configuração do Node.js, se necessário
Configuração da URL RPC da Solana e da chave privada
Configuração da integração com o Claude Desktop

Opção 2: Instalar via npm (recomendado para clientes como Cursor/Cline)

# Install globally
npm install -g solana-mcp

# Or install locally in your project
npm install solana-mcp

Opção 3: Compilar a partir do código-fonte

Clone este repositório:

git clone https://github.com/sendaifun/solana-mcp
cd solana-mcp

Instale as dependências:

pnpm install

Compile o projeto:

pnpm run build

Configuração

Configuração do Ambiente

Crie um arquivo .env com suas credenciais:

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key # OPTIONAL

Integração com o Claude Desktop

Para adicionar este servidor MCP ao Claude Desktop, siga estes passos:

Localize 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

Adicione a Configuração Crie ou edite o arquivo de configuração e adicione o seguinte JSON:

Se você instalou via npm (Opção 1):

{
  "mcpServers": {
    "solana-mcp": {
      "command": "npx",
      "args": ["solana-mcp"],
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",
        "SOLANA_PRIVATE_KEY": "your_private_key_here",
        "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Se você compilou a partir do código-fonte (Opção 2):

{
  "mcpServers": {
    "solana-mcp": {
      "command": "node",
      "args": ["/path/to/solana-mcp/build/index.js"],
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",
        "SOLANA_PRIVATE_KEY": "your_private_key_here",
        "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Reinicie o Claude Desktop Após fazer essas alterações, reinicie o Claude Desktop para que a configuração tenha efeito.

Estrutura do Projeto

solana-agent-kit-mcp/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

Ferramentas Disponíveis

O servidor MCP fornece as seguintes ferramentas de blockchain Solana:

GET_ASSET - Recuperar informações sobre um ativo/token Solana
DEPLOY_TOKEN - Implantar um novo token na Solana
GET_PRICE - Buscar informações de preço de tokens
WALLET_ADDRESS - Obter o endereço da carteira
BALANCE - Verificar o saldo da carteira
TRANSFER - Transferir tokens entre carteiras
MINT_NFT - Criar e cunhar novos NFTs
TRADE - Executar negociações de tokens
REQUEST_FUNDS - Solicitar fundos (útil para testes/desenvolvimento)
RESOLVE_DOMAIN - Resolver nomes de domínio Solana
GET_TPS - Obter transações por segundo atuais na Solana

Considerações de Segurança

Mantenha sua chave privada segura e nunca a compartilhe
Use variáveis de ambiente para informações sensíveis
Considere usar uma carteira dedicada para operações de agentes de IA
Monitore e audite regularmente as atividades dos agentes de IA
Teste operações na devnet/testnet antes da mainnet

Solução de Problemas

Se você encontrar problemas:

Verifique se sua chave privada Solana está correta
Verifique se sua URL RPC está acessível
Certifique-se de estar na rede pretendida (mainnet, testnet ou devnet)
Verifique os logs do Claude Desktop para mensagens de erro
Verifique se a compilação foi bem-sucedida

Dependências

As principais dependências incluem:

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Faça um fork do repositório
Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add some amazing feature')
Envie para a branch (git push origin feature/amazing-feature)
Abra um Pull Request

Licença

Este projeto é licenciado sob a Licença MIT.