 Criando Servidor MCP
Criando Servidor MCP
Um servidor MCP é simplesmente um script Python. Para criar um, comece criando um arquivo .py usando qualquer editor de texto. Uma boa opção é o Visual Studio Code, que é gratuito, fácil para iniciantes e oferece ótimo suporte ao Python. Caso ainda não tenha instalado, acesse o site oficial, baixe a versão adequada para seu sistema e siga as instruções de instalação.
No Visual Studio Code, crie um novo arquivo e nomeie-o como server.py, por exemplo. Este arquivo conterá a lógica do seu servidor.
import.py
Para realmente criar o servidor, será necessário instanciar a classe FastMCP. Inicialmente, isso pode ser feito acessando-a pelo caminho completo do módulo, conforme mostrado abaixo:
main.py
No entanto, digitar constantemente o caminho completo é inconveniente. Uma abordagem mais limpa e legível é alterar a própria declaração de importação. Em vez de importar o módulo inteiro, você pode escrever:
main.py
Agora você possui uma instância básica de servidor armazenada na variável my_mcp. Este servidor pode ser personalizado passando vários argumentos opcionais, como um nome, instruções ou uma lista de ferramentas. Por enquanto, basta atribuir um nome para que você possa acompanhar diferentes servidores caso crie mais de um.
main.py
Se você executar o script, ele termina imediatamente mesmo com uma instrução print. Isso ocorre porque o servidor não foi instruído a permanecer ativo. Para corrigir isso, chame o método run() na sua variável de servidor ao final do script. Isso mantém o servidor online e pronto para tarefas.
main.py
Neste ponto, o servidor está em execução, mas ainda não realiza nenhuma ação. Para torná-lo útil, é necessário definir pelo menos uma ferramenta ou uma função que a IA possa chamar para executar uma tarefa.
Por exemplo, modelos de IA como o Claude não conseguem acessar dados em tempo real por conta própria. Se você perguntar Que horas são?, o Claude informará que não sabe. Mas com um servidor MCP, é possível contornar essa limitação.
Não é necessário escrever o código manualmente. Basta pedir ao Claude para gerar uma função que retorne a hora atual. Cole-a em seu script após criar o servidor. Assim, o servidor estará pronto para executar tarefas.
O Claude irá gerar uma função; você pode ajustar o prompt conforme desejar para obter resultados mais próximos do que precisa. Alternativamente, basta copiar este exemplo.
main.py
Para tornar esta função utilizável pelo servidor, é necessário adicionar um decorador. Esta é uma linha especial de código que fica acima da função e começa com @. Não é necessário entender como ela funciona, apenas saiba que ela informa ao servidor: esta função é uma ferramenta.
file1
Se você deseja entender como os decoradores funcionam em Python e quando usá-los de forma eficaz, confira este artigo Como usar Decorators em Python.
Obrigado pelo seu feedback!
Pergunte à IA
Pergunte à IA
Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo
Awesome!
Completion rate improved to 11.11 Criando Servidor MCP
Criando Servidor MCP
Deslize para mostrar o menu
Um servidor MCP é simplesmente um script Python. Para criar um, comece criando um arquivo .py usando qualquer editor de texto. Uma boa opção é o Visual Studio Code, que é gratuito, fácil para iniciantes e oferece ótimo suporte ao Python. Caso ainda não tenha instalado, acesse o site oficial, baixe a versão adequada para seu sistema e siga as instruções de instalação.
No Visual Studio Code, crie um novo arquivo e nomeie-o como server.py, por exemplo. Este arquivo conterá a lógica do seu servidor.
import.py
Para realmente criar o servidor, será necessário instanciar a classe FastMCP. Inicialmente, isso pode ser feito acessando-a pelo caminho completo do módulo, conforme mostrado abaixo:
main.py
No entanto, digitar constantemente o caminho completo é inconveniente. Uma abordagem mais limpa e legível é alterar a própria declaração de importação. Em vez de importar o módulo inteiro, você pode escrever:
main.py
Agora você possui uma instância básica de servidor armazenada na variável my_mcp. Este servidor pode ser personalizado passando vários argumentos opcionais, como um nome, instruções ou uma lista de ferramentas. Por enquanto, basta atribuir um nome para que você possa acompanhar diferentes servidores caso crie mais de um.
main.py
Se você executar o script, ele termina imediatamente mesmo com uma instrução print. Isso ocorre porque o servidor não foi instruído a permanecer ativo. Para corrigir isso, chame o método run() na sua variável de servidor ao final do script. Isso mantém o servidor online e pronto para tarefas.
main.py
Neste ponto, o servidor está em execução, mas ainda não realiza nenhuma ação. Para torná-lo útil, é necessário definir pelo menos uma ferramenta ou uma função que a IA possa chamar para executar uma tarefa.
Por exemplo, modelos de IA como o Claude não conseguem acessar dados em tempo real por conta própria. Se você perguntar Que horas são?, o Claude informará que não sabe. Mas com um servidor MCP, é possível contornar essa limitação.
Não é necessário escrever o código manualmente. Basta pedir ao Claude para gerar uma função que retorne a hora atual. Cole-a em seu script após criar o servidor. Assim, o servidor estará pronto para executar tarefas.
O Claude irá gerar uma função; você pode ajustar o prompt conforme desejar para obter resultados mais próximos do que precisa. Alternativamente, basta copiar este exemplo.
main.py
Para tornar esta função utilizável pelo servidor, é necessário adicionar um decorador. Esta é uma linha especial de código que fica acima da função e começa com @. Não é necessário entender como ela funciona, apenas saiba que ela informa ao servidor: esta função é uma ferramenta.
file1
Se você deseja entender como os decoradores funcionam em Python e quando usá-los de forma eficaz, confira este artigo Como usar Decorators em Python.
Obrigado pelo seu feedback!