Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Aprenda Criando Servidor MCP | Configuração e Preparação
Criando Agentes de IA Personalizados com Anthropic Claude

bookCriando 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

import.py

copy

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

main.py

copy

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

main.py

copy

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

main.py

copy

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

main.py

copy

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

main.py

copy

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

file1

copy
Note
Estude Mais

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.

question mark

Qual é o principal objetivo de chamar my_mcp.run() no script?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 2. Capítulo 3

Pergunte à IA

expand

Pergunte à IA

ChatGPT

Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo

Awesome!

Completion rate improved to 11.11

bookCriando 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

import.py

copy

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

main.py

copy

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

main.py

copy

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

main.py

copy

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

main.py

copy

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

main.py

copy

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

file1

copy
Note
Estude Mais

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.

question mark

Qual é o principal objetivo de chamar my_mcp.run() no script?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 2. Capítulo 3
some-alt