MCP: Criando um MCP Server no MacOS

From Wiki

Instalando o Claude

brew install claude

Usando o uv para gerenciar seus projetos Python.

brew install uv

Se você ainda não criou um projeto gerenciado pelo uv, crie um:

uv init mcp-server-demo --python=3.11.13
cd mcp-server-demo

Em seguida, adicione o MCP às dependências do seu projeto:

uv add "mcp[cli]"

Para executar o comando mcp com o uv:

uv run mcp

A saída é

Primeiro Servidor

Vamos criar um servidor MCP simples que expõe uma ferramenta de calculadora e alguns dados:

# main.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

Você pode instalar este servidor no Claude Desktop e interagir com ele imediatamente executando:

uv run mcp install main.py

Resultado do comando:

Verificando a configuração Claude. Menu Configuração > Desenvolvedor.

Testando

Pergunte:

Adicionar 2 + 2

O claude vai perguntar se deseja executar o código

O Resultado:

Ver também