Repolode
Enviar
punkpeye

punkpeye/fastmcp

Framework TypeScript para criar servidores MCP que gerenciam sessões de clientes e oferecem ferramentas, recursos, prompts e vários transports.

Ver no GitHubSite
Estrelas
3,278
Forks
332
Issues abertas
5
Último commit
há 10 horas

O que é?

FastMCP é um framework TypeScript para criar servidores Model Context Protocol (MCP). Ele envolve o MCP SDK oficial e cuida do trabalho repetitivo de configurar os componentes do servidor, gerenciar conexões e formatar respostas de ferramentas, recursos e prompts, permitindo que desenvolvedores definam ferramentas com poucas linhas de código. Os schemas podem ser escritos com Zod, ArkType, Valibot ou JSON Schema puro.

Os servidores podem funcionar via stdio, streaming HTTP com compatibilidade com SSE ou HTTPS, e ser implantados nos modos stateful ou stateless. O framework também oferece suporte a autenticação, rastreamento de headers e sessões, sampling, elicitation, roots, notificações de progresso e rotas HTTP personalizadas por meio do app Hono subjacente. Uma variante para edge, EdgeFastMCP, tem como alvo Cloudflare Workers e Deno Deploy.

O projeto tem como alvo as revisões legadas do MCP baseadas em handshake, até 2025-11-25, e não oferece suporte à especificação stateless 2026-07-28.

Recursos principais

  • 01Defina ferramentas, recursos e prompts com uma API simples.
  • 02Valide parâmetros com Zod, ArkType, Valibot ou JSON Schema puro.
  • 03Disponibilize o servidor via stdio, streaming HTTP com compatibilidade com SSE ou HTTPS.
  • 04Execute nos modos stateful ou stateless, inclusive em runtimes de edge.
  • 05Adicione autenticação, rotas HTTP personalizadas do Hono e um endpoint de health check.
  • 06Faça testes usando um transport em memória, a CLI ou o MCP Inspector.

Casos de uso

  • Disponibilizar uma API interna ou um banco de dados como ferramentas que um cliente LLM pode chamar.
  • Criar um servidor MCP remoto ao qual os clientes se conectam por HTTP.
  • Implantar um servidor MCP no Cloudflare Workers ou no Deno Deploy.
  • Escrever testes unitários para servidores MCP sem abrir uma porta de rede.

Início rápido

  1. 1

    Instale o pacote fastmcp pelo npm

    npm install fastmcp
  2. 2

    Crie um arquivo de servidor usando o código Quickstart do README e inicie-o com server.start()

Antes de usar

  • O FastMCP é compatível apenas com as revisões legadas do MCP baseadas em handshake (2025-11-25 e anteriores), não com a especificação atual sem estado de 2026-07-28.

Tópicos

#mcp#typescript#llm#ai-tools#server-framework#sse#edge-computing

Perguntas frequentes

O que é fastmcp?
Framework TypeScript para criar servidores MCP que gerenciam sessões de clientes e oferecem ferramentas, recursos, prompts e vários transports. FastMCP é um framework TypeScript para criar servidores Model Context Protocol (MCP). Ele envolve o MCP SDK oficial e cuida do trabalho repetitivo de configurar os componentes do servidor, gerenciar conexões e formatar respostas de ferramentas, recursos e prompts, permitindo que desenvolvedores definam ferramentas com poucas linhas de código. Os schemas podem ser escritos com Zod, ArkType, Valibot ou JSON Schema puro.
fastmcp é gratuito? Qual é a licença?
fastmcp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
fastmcp ainda é mantido?
Manutenção ativa. O último commit de fastmcp foi em 22 de out. de 2026.
Para que posso usar fastmcp?
Disponibilizar uma API interna ou um banco de dados como ferramentas que um cliente LLM pode chamar. Criar um servidor MCP remoto ao qual os clientes se conectam por HTTP. Implantar um servidor MCP no Cloudflare Workers ou no Deno Deploy. Escrever testes unitários para servidores MCP sem abrir uma porta de rede.
Como instalar fastmcp?
Instale o pacote fastmcp pelo npm: npm install fastmcp Crie um arquivo de servidor usando o código Quickstart do README e inicie-o com server.start()
Onde consigo fastmcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/punkpeye/fastmcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados