FastMCP é um framework TypeScript projetado especificamente para construir servidores Model Context Protocol (MCP). Ele oferece um conjunto completo de ferramentas e funcionalidades, permitindo que desenvolvedores criem rapidamente servidores MCP de alto desempenho capazes de lidar com sessões de clientes.
Endereço do Projeto: https://github.com/punkpeye/fastmcp
npm install fastmcp
import { FastMCP } from "fastmcp";
import { z } from "zod";
const server = new FastMCP({
name: "My Server",
version: "1.0.0",
});
server.addTool({
name: "add",
description: "Add two numbers",
parameters: z.object({
a: z.number(),
b: z.number(),
}),
execute: async (args) => {
return String(args.a + args.b);
},
});
server.start({
transportType: "stdio",
});
As ferramentas permitem que o servidor exponha funções executáveis para o cliente, que podem ser chamadas pelo cliente e usadas pelo LLM para executar operações.
import { z } from "zod";
server.addTool({
name: "fetch-zod",
description: "Fetch the content of a url (using Zod)",
parameters: z.object({
url: z.string(),
}),
execute: async (args) => {
return await fetchWebpageContent(args.url);
},
});
As ferramentas podem conter anotações, fornecendo contexto e informações de controle mais ricos:
server.addTool({
name: "fetch-content",
description: "Fetch content from a URL",
parameters: z.object({
url: z.string(),
}),
annotations: {
title: "Web Content Fetcher",
readOnlyHint: true,
openWorldHint: true,
},
execute: async (args) => {
return await fetchWebpageContent(args.url);
},
});
Os recursos representam qualquer tipo de dado que o servidor MCP deseja fornecer ao cliente, incluindo:
server.addResource({
uri: "file:///logs/app.log",
name: "Application Logs",
mimeType: "text/plain",
async load() {
return {
text: await readLogFile(),
};
},
});
server.addResourceTemplate({
uriTemplate: "file:///logs/{name}.log",
name: "Application Logs",
mimeType: "text/plain",
arguments: [
{
name: "name",
description: "Name of the log",
required: true,
},
],
async load({ name }) {
return {
text: `Example log content for ${name}`,
};
},
});
Os prompts permitem que o servidor defina templates de prompt e fluxos de trabalho reutilizáveis:
server.addPrompt({
name: "git-commit",
description: "Generate a Git commit message",
arguments: [
{
name: "changes",
description: "Git diff or description of changes",
required: true,
},
],
load: async (args) => {
return `Generate a concise but descriptive commit message for these changes:\n\n${args.changes}`;
},
});
FastMCP suporta funcionalidades de autenticação personalizadas:
import { AuthError } from "fastmcp";
const server = new FastMCP({
name: "My Server",
version: "1.0.0",
authenticate: ({ request }) => {
const apiKey = request.headers["x-api-key"];
if (apiKey !== "123") {
throw new Response(null, {
status: 401,
statusText: "Unauthorized",
});
}
return {
id: 1,
};
},
});
Suporte para a funcionalidade SSE para comunicação em tempo real:
server.start({
transportType: "sse",
sse: {
endpoint: "/sse",
port: 8080,
},
});
FastMCP atribui uma nova instância de servidor para cada conexão de cliente, implementando comunicação 1:1:
server.on("connect", (event) => {
console.log("Client connected:", event.session);
});
server.on("disconnect", (event) => {
console.log("Client disconnected:", event.session);
});
npx fastmcp dev src/examples/addition.ts
npx fastmcp inspect src/examples/addition.ts
Adicione a configuração no Claude Desktop:
{
"mcpServers": {
"my-mcp-server": {
"command": "npx",
"args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
"env": {
"YOUR_ENV_VAR": "value"
}
}
}
}
FastMCP foi adotado por vários projetos, incluindo:
FastMCP é um framework TypeScript poderoso e fácil de usar que fornece uma solução completa para construir servidores MCP. Seja para uma simples integração de ferramentas ou para a construção de serviços de IA complexos, o FastMCP pode fornecer a funcionalidade e a flexibilidade necessárias. Seu rico conjunto de recursos e boa experiência do desenvolvedor o tornam uma ferramenta importante no ecossistema MCP.