Repolode
nicobailon

nicobailon/pi-mcp-adapter

Um adaptador que permite ao agente de programação Pi usar servidores MCP por meio de uma única ferramenta proxy, evitando que definições de ferramentas ociosas ocupem a janela de contexto.

Estrelas
1,642
Forks
393
Issues abertas
0
Último commit
há 20 horas

O que é?

pi-mcp-adapter conecta o agente de programação Pi a servidores Model Context Protocol (MCP). Em vez de carregar todas as definições de ferramentas no contexto do modelo, ele disponibiliza uma única ferramenta proxy de aproximadamente 200 tokens, e o agente busca e chama as ferramentas de que precisa sob demanda.

Por padrão, os servidores são iniciados sob demanda: eles começam a funcionar quando são chamados pela primeira vez e param após 10 minutos de inatividade. O adaptador lê arquivos de configuração MCP padrão, como .mcp.json, e pode importar configurações de servidores do Cursor, Claude Code, Codex e VS Code. Ele oferece suporte aos transportes stdio, streamable HTTP, SSE legado e rmcp-mux, autenticação OAuth com tokens armazenados no chaveiro do sistema operacional e MCP prompts, elicitation, sampling e Tasks.

O projeto é uma extensão em TypeScript instalada com npm e compatível com Pi 0.99 ou posterior; nas sessões do Pi, ela substitui o suporte integrado do Pi a MCP.

Recursos principais

  • 01Disponibiliza uma única ferramenta proxy em vez de carregar todas as definições de ferramentas MCP no contexto
  • 02Inicia os servidores sob demanda e os encerra após 10 minutos de inatividade
  • 03Importa configurações de servidores do Cursor, Claude Code, Codex e VS Code
  • 04Oferece suporte aos transportes stdio, streamable HTTP, SSE legado e rmcp-mux
  • 05Armazena tokens OAuth no chaveiro do sistema operacional
  • 06Busca semântica de ferramentas opcional com uma chave do System One

Casos de uso

  • Dar a um agente de programação acesso a bancos de dados, navegadores ou APIs via MCP sem sobrecarregar o contexto
  • Instalar muitos servidores MCP e pagar apenas pelos que estiverem em uso
  • Reutilizar configurações de servidores MCP já feitas no Cursor ou no Claude Code

Início rápido

  1. 1

    Instale o adaptador no Pi

    pi install npm:pi-mcp-adapter
  2. 2

    Reinicie o Pi após a instalação

  3. 3

    Adicione um servidor ao .mcp.json do seu projeto (veja o exemplo no README)

Antes de usar

  • Funciona apenas com o agente de programação Pi, não como um cliente MCP independente.
  • A busca semântica de ferramentas requer uma chave do System One; a busca por palavras e expressões regulares funciona sem ela.

Em coleções

Tópicos

Perguntas frequentes

O que é pi-mcp-adapter?
Um adaptador que permite ao agente de programação Pi usar servidores MCP por meio de uma única ferramenta proxy, evitando que definições de ferramentas ociosas ocupem a janela de contexto. pi-mcp-adapter conecta o agente de programação Pi a servidores Model Context Protocol (MCP). Em vez de carregar todas as definições de ferramentas no contexto do modelo, ele disponibiliza uma única ferramenta proxy de aproximadamente 200 tokens, e o agente busca e chama as ferramentas de que precisa sob demanda.
pi-mcp-adapter é gratuito? Qual é a licença?
pi-mcp-adapter é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
pi-mcp-adapter ainda é mantido?
Manutenção ativa. O último commit de pi-mcp-adapter foi em 6 de nov. de 2026.
Para que posso usar pi-mcp-adapter?
Dar a um agente de programação acesso a bancos de dados, navegadores ou APIs via MCP sem sobrecarregar o contexto Instalar muitos servidores MCP e pagar apenas pelos que estiverem em uso Reutilizar configurações de servidores MCP já feitas no Cursor ou no Claude Code
Como instalar pi-mcp-adapter?
Instale o adaptador no Pi: pi install npm:pi-mcp-adapter Reinicie o Pi após a instalação Adicione um servidor ao .mcp.json do seu projeto (veja o exemplo no README)
Onde consigo pi-mcp-adapter?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nicobailon/pi-mcp-adapter

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

Projetos relacionados