MCP Starter Server

MCP Starter Server

Um template mínimo de servidor ModelContextProtocol para construir ferramentas de assistentes de IA. Este starter fornece uma estrutura básica para criar ferramentas MCP que podem ser usadas com assistentes de IA como o Claude.

Recursos

• Exemplo simples de ferramenta "hello world"
• Configuração TypeScript + esbuild
• Ferramentas de desenvolvimento pré-configuradas

Configuração para construir e executar com Claude

1. Baixe e instale o aplicativo de desktop Claude em claude.ai/download

2. Clone o repositório, instale as dependências e faça o build:

npm install
npm run build

3. Configure o Claude para usar este servidor MCP. Se este for o seu primeiro servidor MCP, na raiz deste projeto execute:

echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

Isso deve resultar em uma entrada no seu claude_desktop_config.json como:

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

Se você já possui servidores MCP, adicione o bloco mcp-starter à sua configuração existente. É um detalhe importante que o args seja o caminho para <path_to_repo_on_your_machine>/mcp-starter/dist/index.cjs.

4. Reinicie o Claude Desktop.

5. Procure pelo ícone de martelo com o número de ferramentas disponíveis na interface do Claude para confirmar que o servidor está em execução.

6. Se tudo estiver funcionando, você poderá desenvolver seu servidor MCP usando npm run dev e testá-lo no Claude. Você precisará reiniciar o Claude a cada vez para reiniciar o servidor MCP.

Desenvolvendo com Inspector

Para fins de desenvolvimento e depuração, você pode usar a ferramenta MCP Inspector. O Inspector fornece uma interface visual para testar e monitorar interações do servidor MCP.

Visite a documentação do Inspector para instruções detalhadas de configuração.

Para testar localmente com o Inspector:

npm run inspect

Para compilar em alterações de arquivo, execute:

npm run watch

Ou execute tanto o watcher quanto o inspector:

npm run dev

Publicação

Quando estiver pronto para distribuir seu servidor, é simples!

1. Crie uma conta NPM.

2. Execute npm publish. Isso publicará um pacote usando o nome do projeto em package.json

3. Uma vez publicado, outros poderão instalar o servidor com uma entrada de configuração como:

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

Ferramentas Disponíveis

O servidor fornece:

• hello_tool: Um exemplo simples de ferramenta que recebe um parâmetro de nome e retorna uma saudação

Criando Novas Ferramentas

Para adicionar novas ferramentas:

1. Defina o esquema da ferramenta em index.ts
2. Adicione-a ao array de ferramentas no handler ListToolsRequestSchema
3. Adicione a implementação no handler CallToolRequestSchema

Veja a implementação de hello_tool como exemplo.