convez.ai
MCP ServerDesenvolvimento WebIntermediário
harshaldonarkar

MCP Server Demo

harshaldonarkar/mcp-server-demo

Exemplos progressivos de MCP servers: do minimal ao full Node.js assistant

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleção de exemplos independentes de servidores Model Context Protocol (MCP) construídos com FastMCP em Python. Vai de um servidor minimal até um assistente completo de projetos Node.js com ~2500 linhas, demonstrando ferramentas, recursos dinâmicos, templates de prompts e gerenciamento de ciclo de vida.

Instalação

$npx convez-ai harshaldonarkar/mcp-server-demo

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Aprender a construir servidores MCP com FastMCP
  • Prototipar assistentes de IA para projetos específicos (Node.js, TypeScript, React)
  • Entender recursos dinâmicos, ferramentas síncronas/assíncronas e templates de prompts
  • Gerar scaffold de projetos, componentes React, testes Jest e configurações DevOps via Claude

Veredito

Referência prática e bem-estruturada para quem quer dominar o protocolo MCP em Python. Ideal para construir assistentes especializados, mas exige familiaridade com MCP e FastMCP SDK.

README

A tradução para o português deste README ainda está na fila.

mcp-server-demo

A collection of standalone Model Context Protocol server examples built with the Python FastMCP SDK. Each file at the repo root is an independent server illustrating a different slice of the API.

Requirements

  • Python 3.13 (see .python-version)
  • uv for dependency management

Setup

uv sync

The servers

FileWhat it shows
server.pyMinimal "Demo" server: one add tool, one dynamic greeting://{name} resource. The smallest end-to-end example.
comprehensive_server.pyLifespan management with a typed dataclass context, static + dynamic resources, sync/async tools, progress reporting via Context, and prompt templates (string and message-list forms).
node_mcp_server.pyLarge Node.js project-assistant server (~2500 lines). Tools for scaffolding TypeScript/Next.js projects, creating React components, generating Jest tests, ESLint/Prettier setup, Docker scaffolding, npm operations, performance tests, and TS conversion.
node_mcp_server_minimal.pyStripped-down sanity-check variant of the Node.js server with just one tool and one resource.

Running

Each server speaks MCP over stdio when run directly:

uv run python server.py
uv run python comprehensive_server.py
uv run python node_mcp_server.py

For interactive development, use the FastMCP CLI to launch the MCP Inspector:

uv run mcp dev server.py

To register a server with Claude Desktop:

uv run mcp install server.py

Note: the dependencies=[...] argument to FastMCP(...) (used by node_mcp_server.py for httpx) only applies to the isolated environment that mcp install creates. For uv run, runtime deps live in pyproject.toml — already set up here via uv sync.

Project layout

.
├── server.py                       # minimal demo
├── comprehensive_server.py         # lifespan / context / progress / prompts
├── node_mcp_server.py              # full Node.js project assistant
├── node_mcp_server_minimal.py      # minimal Node.js sanity-check variant
├── pyproject.toml                  # uv project, depends on mcp[cli] + httpx
└── uv.lock

The four servers share no code — each is self-contained.

Ver o original no GitHub

Bom para

Relacionados