Solana Dev MCP

Um servidor MCP para desenvolvimento Solana que fornece métodos RPC básicos e prompts úteis.

Documentação

Demonstração do Protocolo de Contexto de Modelo (MCP) para Solana

Este repositório demonstra uma implementação simples de um servidor de Protocolo de Contexto de Modelo (MCP) para desenvolvimento na Solana.

O que é MCP?

O Protocolo de Contexto de Modelo (MCP) é uma interface padronizada para que modelos de IA interajam com ferramentas e recursos. Esta demonstração apresenta uma implementação simples de servidor MCP que fornece:

Métodos RPC básicos para Solana (getBalance, getAccountInfo, getTransaction)
Alguns prompts úteis para desenvolvimento na Solana

Pré-requisitos

Node.js (v16 ou superior recomendado)
Gerenciador de pacotes pnpm (v9.10.0 ou compatível)

Instalação

Clone este repositório e instale as dependências:

git clone https://github.com/solana-foundation/solana-dev-mcp.git
cd solana-dev-mcp
pnpm install

Para executar este servidor no inspetor MCP, use:

npx @modelcontextprotocol/inspector ts-node index.ts

Começando

Explore o código: A implementação principal está em index.ts, que configura um servidor MCP com ferramentas simples de busca e alguns prompts.
Modifique o servidor: Você pode estender o servidor adicionando mais ferramentas, recursos e prompts.
Obtenha ideias para extensões: Consulte a seção Ideias para Estender o MCP para Desenvolvimento na Solana para se inspirar em novas ferramentas e recursos para adicionar.

Exemplo de Uso

Esta seção explica como usar o servidor MCP da Solana no Claude. Siga os mesmos passos para usar o servidor MCP da Solana no Windsurf e no Cursor.

Gerar o arquivo de configuração

Para usar este servidor MCP da Solana, você precisa gerar um arquivo de configuração que o Claude possa usar para se conectar ao servidor. Execute um dos seguintes comandos para gerar o arquivo de configuração:

pnpm generate-config se você tiver o ts-node instalado globalmente
pnpm build && pnpm generate-config:js se você não tiver o ts-node instalado globalmente

Isso imprimirá uma configuração JSON com o seguinte conteúdo:

Se você tiver o ts-node:

{
  "mcpServers": {
    "solana-dev": {
      "command": "ts-node",
      "args": ["<full-path-to-repo>/index.ts"]
    }
  }
}

Se você não tiver o ts-node instalado globalmente:

{
  "mcpServers": {
    "solana-dev": {
      "command": "node",
      "args": ["<full-path-to-repo>/dist/index.js"]
    }
  }
}

Estrutura do Projeto

index.ts - Implementação principal do servidor
package.json - Dependências do projeto e metadados
tsconfig.json - Configuração do TypeScript

Ideias para Estender o MCP para Desenvolvimento na Solana

Esta implementação de servidor MCP fornece uma base que você pode estender ou bifurcar para suas próprias necessidades de desenvolvimento na Solana. Aqui estão algumas ideias para começar:

Ideias para Extensão

Estimador de Taxa de Prioridade: Adicione uma ferramenta que estime taxas de prioridade ideais para transações na Solana com base na atividade recente da rede. Isso pode ajudar os usuários a otimizar os custos de transação enquanto garante o processamento em tempo hábil.
Depurador Solana Verify: Crie uma ferramenta que ajude a depurar problemas com o solana-verify fornecendo informações mais detalhadas sobre o processo de verificação.
Inspetor de security.txt da Solana: Construa uma ferramenta que extraia e exiba as informações do arquivo security.txt para um determinado programa da Solana, facilitando o contato com os mantenedores do programa em caso de preocupações de segurança.
Auxiliar Squads para Implantação de Programas: Crie uma ferramenta que automatize o processo de implantação e atualização de programas da Solana, facilitando o gerenciamento do estado do programa em vários ambientes.
Explicador de Erros Anchor: Desenvolva uma ferramenta que receba um código de erro e consulte a mensagem de erro legível correspondente no banco de dados de códigos de erro do Anchor.
Prompts Aprimorados: Expanda as capacidades de prompt do servidor para fornecer sugestões mais conscientes do contexto para tarefas de desenvolvimento na Solana. Por exemplo, adicione prompts para padrões comuns de transação, criação de contas ou operações com tokens.
Construtor de Transações: Crie ferramentas que ajudem a construir transações complexas com múltiplas instruções, facilitando a interação com vários programas da Solana.
Endpoints RPC Personalizados: Permita a configuração de endpoints RPC personalizados, incluindo suporte para provedores RPC privados ou validadores locais.
Auxiliares de Implantação de Programas: Crie ferramentas que simplifiquem o processo de implantação e atualização de programas da Solana.
Explorador de Contas e Transações: Adicione uma ferramenta que receba um ID de conta ou transação e exiba o conteúdo em um formato legível, semelhante a uma visão de explorador. Isso pode ser útil para inspecionar dados de transação ou estado de conta sem precisar decodificar os dados manualmente.
Documentação da Solana, Anchor e Protocolo: Adicione recursos que carreguem a documentação da Solana, Anchor e Protocolo diretamente no editor MCP, fornecendo acesso fácil a informações relevantes sem precisar sair do editor. Isso pode ser implementado buscando a documentação dos respectivos repositórios e servindo-a como recursos do servidor MCP.

Como Contribuir

Se você construiu uma extensão que pode ser útil para outros, considere enviar um pull request para este repositório. Certifique-se de seguir estas diretrizes:

Mantenha seu código bem documentado
Inclua testes para novas funcionalidades
Siga o estilo de código existente
Atualize o README com informações sobre sua adição

Segurança

Este é um exemplo simples e não deve ser usado em produção. MCP é um padrão novo e carece de medidas de segurança adequadas.

Tenha muito cuidado ao instalar e experimentar servidores MCP de desenvolvedores desconhecidos.

Use um ambiente isolado (sandbox) ao experimentar servidores MCP, sem informações críticas nele para evitar danos potenciais.