xMCP Server

Servidor xMCP

xMCP é um servidor MCP HTTP streamable que faz proxy de requisições para servidores MCP stdio.

Já existem vários servidores MCP proxy por aí, mas nenhum deles resolve o seguinte problema:

E se o servidor MCP stdio que eu quero usar utiliza um comando que não está disponível no meu sistema?

A resposta é usar o xMCP!

Como funciona

Considere o seguinte exemplo:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Este comando só funcionará se você tiver o npx instalado.

Para usar este servidor MCP, transforme-o no seguinte:

http://localhost:3001/mcp?name=context7&command=npx&args=-y,@upstash/context7-mcp

Ao enviar esta requisição pela rede, você poderá usar o servidor MCP stdio context7 pela rede.

Por que funciona?

O xMCP está rodando dentro de um contêiner com os comandos mais comuns pré-instalados. Adicione o que precisar ao contêiner e está pronto! (E considere criar um PR se achar que outros também se beneficiariam disso.)

Comandos disponíveis

• npx
• bunx
• uv
• docker

Como usar

Desenvolvimento Local

docker compose up -d

# or

make start

O servidor está rodando em http://localhost:3001/mcp.

O Inspector está rodando em http://localhost:6274, porém, ele requer um token definido na URL.

Execute o make logs, obtenha a URL com o token de autenticação e abra-a.