html 🛰️ Suporte MCP | Nullcore
Pule para o conteúdo principal

🛰️ Suporte MCP

Esta documentação explica como configurar e implantar facilmente oMCP (Model Context Protocol)-Servidor proxy de abertura(MCPO)Fornecido pelo Nullcore. Saiba como você pode expor sem esforço os servidores de ferramentas baseados em MCP usando pontos de extremidade OpenAPI padrão e familiar, adequados para usuários finais e desenvolvedores.

📌 O que é o servidor proxy do MCP?

O servidor proxy MCP para openapi permite que você use servidores de ferramentas implementados com o MCP (Model Context Protocol) diretamente por meio de APIs padrão de REST/OpenAPI-não precisa gerenciar protocolos personalizados não familiarizados ou complicados. Se você é um usuário final ou desenvolvedor de aplicativos, isso significa que você pode interagir facilmente com ferramentas poderosas baseadas em MCP diretamente por meio de pontos de extremidade familiares.

💡 Por que usar o MCPO?

Embora os servidores de ferramentas MCP sejam poderosos e flexíveis, eles geralmente se comunicam por meio de entrada/saída padrão (STDIO) - geralmente em execução em sua máquina local, onde podem acessar facilmente o sistema de arquivos, o ambiente e outros recursos do sistema nativo.

Isso é uma força - mas também uma limitação.

Se você deseja implantar sua interface principal (como o Nullcore) na nuvem, você rapidamente se depara com um problema: sua instância em nuvem não pode falar diretamente com um servidor MCP em execução localmente em sua máquina via Stdio.

É aí que o MCPO entra com uma solução que muda o jogo.

Os servidores MCP normalmente dependem da comunicação bruta do stdio, que é:

  • 🔓 inerentemente inseguro em ambientes
  • ❌ Incompatível com a maioria das ferramentas, UIs ou plataformas modernas
  • 🧩 Falta recursos críticos como autenticação, documentação e manuseio de erros

O proxy do MCPO elimina esses problemas - automaticamente:

  • ✅ Compatível instantaneamente com as ferramentas, SDKs e clientes existentes OpenApi
  • 🛡 envolve suas ferramentas com pontos de extremidade HTTP seguros, escaláveis ​​e baseados em padrões
  • 🧠 Documentação interativa do OpenAPI interativo para todas as ferramentas, totalmente sem configuração
  • 🔌 Usa http simples-sem configuração do soquete, malabarismo com daemon ou código de cola específico da plataforma

Portanto, embora acrescentar que o MCPO possa parecer "apenas mais uma camada" - na realidade, simplifica tudo enquanto lhe dá:

  • Melhor integração ✅
  • Melhor segurança ✅
  • Melhor escalabilidade ✅
  • Desenvolvedores e usuários mais felizes ✅

✨ Com o MCPO, suas ferramentas de IA somente local se tornam prontas para a nuvem, amigáveis ​​à UI e instantaneamente interoperáveis-sem alterar uma única linha de código do servidor de ferramentas.

✅ Quickstart: executando o proxy localmente

Veja como é simples lançar o servidor proxy MCP para openápio usando a ferramenta leve e fácil de usarMcPoRepositório do GitHub

  1. Pré -requisitos

    • Python 3.8+compipinstalado.
    • Aplicativo compatível com MCP (por exemplo:mcp-server-time
    • (Opcional, mas recomendado)uvInstalado para uma inicialização mais rápida e conveniência zero-config.

  2. Instale o MCPO

UsandoUV(recomendado):

UVX MCPO --PORT 8000 -Your_MCP_SERVER_COMMAND

Ou usandopip

pip install mcpo
MCPO --PORT 8000 -Your_MCP_SERVER_COMMAND
  1. Execute o servidor proxy

Para iniciar seu servidor proxy MCP para openápio, você precisa de um servidor de ferramentas compatível com MCP. Se você ainda não tem um, a comunidade MCP fornece várias implementações de servidor MCP prontas para uso.

Onde encontrar servidores MCP?

Você pode descobrir os servidores MCP oficialmente suportados no exemplo do repositório a seguir:

Por exemplo, o popularTime MCP Serverestá documentadoaqui, e geralmente é referenciado claramente no ReadMe, dentro da configuração MCP fornecida. Especificamente, o ReadMe afirma:

Adicione às suas configurações de Claude:

"McPservers" {   
  "tempo" {     
    "comando" "UVX", Assim,     
    "Args" [["MCP-server-time", Assim, "-Local-timeZone = America/New_york"

Traduzindo essa configuração do MCP para um rápido comando local de proxy

Você pode executar facilmente o servidor MCP recomendado (mcp-server-time) diretamente através doProxy MCP-para-Openapimcpo) assim:

UVX MCPO --PORT 8000-UVX MCP-Server-Time-Local-timeZone = America/New_york

É isso! Agora você está executando o proxy MCP-to-Openapi localmente e expondo o poderosoMCP Time ServerAtravés de pontos de extremidade Standard OpenAPI acessíveis em:

Sinta -se à vontade para substituiruvx mcp-server-time --local-timezone=America/New_Yorkcom o comando preferido do servidor MCP de outras implementações MCP disponíveis encontradas no repositório oficial.

Para integrar -se com o Nullcore após o lançamento do servidor, verifique nossodocumentos

🚀 Acessando as APIs geradas

Assim que começa, o proxy do MCP (mcpo) automaticamente:

  • Descobra as ferramentas do MCP dinamicamente e gera pontos de extremidade REST.
  • Cria documentação interativa e legível por humanos, acessível em:
    • http://localhost:8000/docs

Basta ligar para os pontos de extremidade da API gerada automaticamente diretamente por meio de clientes HTTP, agentes de IA ou outras ferramentas do OpenAPI de sua preferência.

📖 Exemplo de fluxo de trabalho para usuários finais

Supondo que você tenha iniciado o comando do servidor acima (uvx mcp-server-time

  • Visite sua documentação da API local emhttp://localhost:8000/docs
  • Selecione um terminal gerado (por exemplo/get_current_time) e use o formulário interativo fornecido.
  • Clique em "Executar"E receba instantaneamente sua resposta.

Sem complexidade de configuração - apenas APIs instantâneas de repouso.

🚀 Implantando na produção (exemplo)

A implantação do seu proxy MCP para openapi (alimentada pelo MCPO) é direta. Veja como dockerize e implantá -lo facilmente nas soluções em nuvem ou vps:

🐳 Dockerize seu servidor proxy usando MCPO

  1. Exemplo de Dockerfile

Crie o seguinteDockerfileDentro do seu diretório de implantação:

De Python: 3.11-Slim
WorkDir /App
Execute o pip install mcpo uv
# Substitua pelo comando MCP Server; Exemplo: UVX MCP-server-time
CMD ["UVX", "MCPO", "--HOST", "0.0.0.0", "--port", "8000", "-", "UVX", "MCP-server-time", "-Local-TimeZone = America/New_york"]
  1. Construa e execute o contêiner localmente
Docker Build -t MCP-Proxy-Server.
Docker Run -d -p 8000: 8000 mcp -proxy -server
  1. Implantando seu contêiner

Empurre para o DockerHub ou outro registro:

Docker tag mcp-proxy-server yourdockerusername/mcp-proxy-server: mais recente
Docker Push YourDockerusername/MCP-Proxy-Server: mais recente

Implante usando o Docker Compose, o Kubernetes YAML manifesta ou seus serviços favoritos de contêineres em nuvem (AWS ECS, instâncias de contêineres do Azure, render.com ou Heroku).

✔️ Seus servidores MCP de produção agora estão disponíveis sem esforço por meio de APIs REST!

🧑‍💻 Detalhes técnicos e fundo

🍃 Como funciona (resumo técnico)

  • Descoberta e terminais de esquema dinâmico:Na inicialização do servidor, o proxy se conecta ao servidor MCP para consultar as ferramentas disponíveis. Ele constrói automaticamente os pontos de extremidade do FASTAPI com base nos esquemas de ferramentas MCP, criando pontos de extremidade de repouso conciso e claro.

  • Documentação automática OpenAPI:Os terminais gerados são perfeitamente documentados e disponíveis através da interface do usuário do Swagger embutida da FASTAPI (/docs). Não é necessária uma redação de documentos extras.

  • Assíncrono e performante: Construído em bibliotecas assíncronas robustas, garantindo velocidade e confiabilidade para usuários simultâneos.

📚 sob o capô:

  • FASTAPI (roteamento automático e geração de documentos)
  • Cliente MCP (Integração MCP padrão e descoberta de esquema)
  • JSON padrão sobre HTTP (fácil integração)

⚡️ Por que o MCP-to-Openapi Proxy é superior?

Eis por que alavancar os servidores MCP através do OpenAPI por meio da abordagem de proxy é significativamente melhor e por que o Nullcore suporta com entusiasmo:

  • Interface amigável e familiar: Nenhum cliente personalizado; Apenas pontos de extremidade HTTP REST que você já conhece.
  • Integração instantânea: Imediatamente compatível com milhares de ferramentas, SDKs e serviços de repouso/abertura existentes.
  • Documentos poderosos e automáticos: A documentação da interface do swagger embutida é gerada automaticamente, sempre precisa e mantida.
  • Nenhum novo protocolo sobrecarga: Elimina a necessidade de lidar diretamente com as complexidades de protocolo específico do MCP e problemas de comunicação de soquete.
  • Segurança e estabilidade testadas por batalha: Herda o transporte HTTPS bem estabelecido, métodos de autenticação padrão (JWT, API Keys), bibliotecas de assíncronas sólidas e robustez comprovada da FASTAPI.
  • À prova de futuro: O proxy do MCP usa formatos de repouso/openapi existentes, estáveis ​​e openAPI, garantidos de apoio e evolução da comunidade de longo prazo.

Resumindo:O MCP-To-Openapi torna suas poderosas ferramentas de AI baseadas em MCP amplamente acessíveis por meio de pontos de extremidade de restos intuitivos, confiáveis ​​e escaláveis. O Nullcore suporta orgulhosamente e recomenda essa melhor abordagem da categoria.

📢 Comunidade e apoio

Integrações felizes! 🌟🚀