Skip to main content
Glama
wganalytics

mcp-resources-giulia-ai

by wganalytics

PRJ-03 — Servidor de Resources MCP

Servidor MCP (FastMCP, stdio) que demonstra Resources — a forma padronizada do MCP expor dados (em vez de tools) para o modelo. Corresponde ao Capítulo 4 do livro Model Context Protocol (Sandeco).

Resources expostos

URI

Tipo

Conteúdo

echo://static

estático

Identidade do agente (nome via AGENT_NAME, default Giulia-ai).

file://readme

arquivo

Bytes reais deste README.md.

file://contatos

arquivo

CSV de contatos (dados de demonstração).

contato://{nome}

template dinâmico

Busca UM contato pelo nome dentro do CSV.

greeting://{nome}

template dinâmico

Saudação personalizada.

Correções em relação ao exemplo do livro: caminhos de arquivo agora são resolvidos via pathlib relativos à raiz do projeto (antes eram relativos ao diretório de execução e quebravam), e o CSV correto em data/contatos.csv.

Related MCP server: Hello World MCP Server

Uso

uv sync
cp .env.example .env        # opcional: definir AGENT_NAME
uv run python src/resources_server.py   # ou: uv run python src/main.py

Os dados de contato são fictícios (demo). Para um cenário real, aponte CONTATOS_PATH para um export do seu CRM ou troque o resource por uma consulta a banco/API.

Testes

uv run pytest        # 20 testes

Cobrem os três formatos de resource e, principalmente, que os caminhos resolvem a partir da raiz do projeto — rodar de outra pasta não pode quebrar.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A simple demonstration MCP server that provides basic greeting functionality and server information. Enables users to generate hello messages and retrieve server details through tools and resources.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides basic tools for arithmetic operations (addition) and dynamic greeting resources, demonstrating MCP integration patterns for other projects and clients.
    9 npm
    ISC
  • F
    license
    Not graded
    quality
    D
    maintenance
    A simple MCP server that exposes a calculator tool (addition) and a dynamic greeting resource.
    16
    -