Hello World MCP Server

Um servidor MCP Hello World simples construído com FastMCP, servindo como um exemplo básico.

Documentação

Servidor MCP Hello World

Um servidor MCP (Model Context Protocol) "Hello World" simples, construído com FastMCP. Este servidor demonstra funcionalidades básicas do MCP com várias ferramentas de exemplo.

Início Rápido

Usando uvx com GitHub (Recomendado)

Você pode executar este servidor MCP diretamente do GitHub usando uvx:

uvx --from git+https://github.com/macsymwang/hello-mcp-server.git hello-mcp-server

Configuração do Cliente MCP

Adicione isto à configuração do seu cliente MCP:

{
  "mcpServers": {
    "hello-world": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/macsymwang/hello-mcp-server.git", "hello-mcp-server"]
    }
  }
}

Recursos

say_hello: Cumprimenta alguém com uma mensagem personalizada
get_server_info: Obtém informações sobre o servidor MCP
echo_message: Ecoa de volta qualquer mensagem que você enviar
count_words: Analisa texto e conta palavras/caracteres

Instalação

Usando uvx com GitHub (Recomendado)

Você pode executar este servidor MCP diretamente do GitHub usando uvx:

uvx --from git+https://github.com/macsymwang/hello-mcp-server.git hello-mcp-server

Usando uvx do PyPI (se publicado)

uvx hello-mcp-server

Instalação Local

Clone ou baixe este repositório
Instale o pacote:

pip install .

Execute o servidor:

hello-mcp-server

Instalação para Desenvolvimento

Para desenvolvimento, instale em modo editável:

pip install -e .

Uso

Registrando como Protocolo Stdio

Este servidor MCP foi projetado para funcionar com o protocolo de transporte stdio, que é a forma padrão dos servidores MCP se comunicarem com clientes. O servidor lê mensagens JSON-RPC da entrada padrão e escreve respostas na saída padrão.

Configuração do Cliente MCP

Claude Desktop

Adicione esta configuração ao arquivo de configuração do Claude Desktop (geralmente localizado em ~/.config/claude/claude_desktop_config.json no Linux/Mac ou %APPDATA%\Claude\claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "hello-world": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/macsymwang/hello-mcp-server.git", "hello-mcp-server"]
    }
  }
}

IDE Cursor

Adicione isto à configuração MCP do Cursor:

{
  "mcpServers": {
    "hello-world": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/macsymwang/hello-mcp-server.git", "hello-mcp-server"],
      "transport": {
        "type": "stdio"
      }
    }
  }
}

Cliente MCP Genérico

Para outros clientes MCP, use esta configuração:

{
  "mcpServers": {
    "hello-world": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/macsymwang/hello-mcp-server.git", "hello-mcp-server"],
      "env": {},
      "transport": {
        "type": "stdio"
      }
    }
  }
}

Executando o Servidor Manualmente

O servidor também pode ser iniciado manualmente para testes:

Usando uvx (recomendado):
```
uvx hello-mcp-server
```
Usando o comando instalado:
```
hello-mcp-server
```
Usando o módulo Python:
```
python -m hello_mcp_server.server
```
Execução direta:
```
python hello_mcp_server/server.py
```

Quando executado manualmente, o servidor aguardará mensagens JSON-RPC na entrada padrão. Você pode testá-lo enviando mensagens do protocolo MCP, mas normalmente ele é usado através de clientes MCP.

Ferramentas Disponíveis

say_hello

Cumprimenta alguém com uma mensagem personalizada.

Parâmetros:

name (opcional): Nome da pessoa a cumprimentar (padrão: "World")

Exemplo:

{
  "name": "Alice"
}

get_server_info

Retorna informações sobre o servidor MCP.

Parâmetros: Nenhum

echo_message

Ecoa de volta a mensagem fornecida.

Parâmetros:

message (obrigatório): A mensagem a ser ecoada

count_words

Analisa texto e fornece estatísticas de palavras/caracteres.

Parâmetros:

text (obrigatório): O texto a ser analisado

Configuração

Protocolo Stdio

Este servidor MCP usa o protocolo de transporte stdio, o que significa:

Entrada: O servidor lê mensagens JSON-RPC da entrada padrão (stdin)
Saída: O servidor escreve respostas JSON-RPC na saída padrão (stdout)
Registro: Mensagens de erro e logs são escritas na saída de erro padrão (stderr)

Este é o protocolo padrão para servidores MCP e garante compatibilidade com todos os clientes MCP.

Configuração de Transporte

O servidor se configura automaticamente para transporte stdio quando iniciado. Nenhuma configuração adicional é necessária para a camada de transporte.

Para opções avançadas de configuração do FastMCP, consulte a documentação do FastMCP.

Requisitos

Python 3.8+
fastmcp>=0.1.0

Estrutura do Projeto

hello-mcp-server/
├── hello_mcp_server/
│   ├── __init__.py
│   └── server.py
├── pyproject.toml
└── README.md

Desenvolvimento

Para contribuir com este projeto:

Faça um fork do repositório
Crie um branch de funcionalidade
Faça suas alterações
Adicione testes, se aplicável
Envie um pull request

Licença

Este projeto é open source. Verifique o arquivo de licença para detalhes.

Suporte

Para problemas e perguntas, abra uma issue no repositório do projeto.