MCP Server Demo
harshaldonarkar/mcp-server-demo
Exemplos progressivos de MCP servers: do minimal ao full Node.js assistant
Ver no GitHubColeçã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-demo1 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
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
| File | What it shows |
|---|---|
server.py | Minimal "Demo" server: one add tool, one dynamic greeting://{name} resource. The smallest end-to-end example. |
comprehensive_server.py | Lifespan 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.py | Large 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.py | Stripped-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 toFastMCP(...)(used bynode_mcp_server.pyforhttpx) only applies to the isolated environment thatmcp installcreates. Foruv run, runtime deps live inpyproject.toml— already set up here viauv 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.