pedrotiagocontador-netizen/pluggy-mcp-server

Servidor MCP para Integração com a API Pluggy

Este projeto implementa um servidor MCP (Model Context Protocol) para interagir com a API da Pluggy, permitindo que LLMs e agentes de IA acessem dados financeiros de forma segura e estruturada. O servidor é construído com Node.js, TypeScript e Express, e está pronto para deploy em diversas plataformas de nuvem.

Funcionalidades

• Integração Completa com a Pluggy: Suporte para listar conectores, criar e gerenciar conexões (items), buscar contas e extrair transações.
• Interface MCP Padronizada: Expõe as funcionalidades da Pluggy como tools que podem ser chamadas por qualquer cliente MCP compatível, como o Manus.
• Autenticação Segura: Gerencia automaticamente a autenticação com a API da Pluggy, utilizando clientId e clientSecret para obter e renovar tokens de acesso.
• Pronto para Deploy: Inclui configurações para deploy rápido em plataformas como Vercel, Heroku, Railway e AWS Lambda.
• Desenvolvimento Local Simplificado: Configurado com Docker e ts-node para um ambiente de desenvolvimento rápido e consistente.

1. Configuração do Ambiente

Pré-requisitos

• Node.js (versão 20 ou superior)
• npm (geralmente instalado com o Node.js)
• Docker (opcional, para desenvolvimento em contêiner)
• Credenciais da API Pluggy (clientId e clientSecret).

Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto, baseado no .env.example. Substitua os valores pelas suas credenciais da Pluggy.

# Credenciais da API Pluggy
PLUGGY_CLIENT_ID=1605f728-62e7-4861-9c3f-19d5a7c1c645
PLUGGY_CLIENT_SECRET=d96da63a-9e07-4536-b6c4-3910d7b83bad

# Configuração do Servidor
PORT=3000
NODE_ENV=development

# URL Base da API Pluggy
PLUGGY_API_URL=https://api.pluggy.ai

2. Executando Localmente

Instalação de Dependências

npm install

Modo de Desenvolvimento

Para iniciar o servidor em modo de desenvolvimento com hot-reload:

npm run dev

O servidor estará disponível em http://localhost:3000.

Usando Docker (Opcional)

Para executar o servidor em um contêiner Docker:

docker-compose up --build

3. Build e Produção

Para compilar o código TypeScript para produção:

npm run build

Os arquivos compilados serão gerados no diretório dist/.

Para iniciar o servidor em modo de produção:

npm start

4. Deploy em Nuvem

O projeto está pré-configurado para deploy em várias plataformas.

Vercel

1. Conecte seu repositório Git à Vercel.
2. A Vercel detectará automaticamente o projeto Node.js.
3. Configure as variáveis de ambiente PLUGGY_CLIENT_ID e PLUGGY_CLIENT_SECRET no dashboard da Vercel.
4. Faça o deploy. O arquivo vercel.json cuidará do resto.

Heroku

1. Crie uma nova aplicação no Heroku.
2. Configure as variáveis de ambiente no dashboard (Config Vars).
3. Conecte seu repositório e faça o deploy. O Procfile instruirá o Heroku a iniciar o servidor web.

Outras Plataformas

• Railway: Utilize o arquivo railway.json para deploy automático.
• AWS Lambda: O arquivo serverless.yml pode ser usado com o Serverless Framework para deploy na AWS.

5. Integração com o Manus

Após o deploy, você pode adicionar este servidor como um MCP personalizado no Manus.

1. Abra o arquivo manus-mcp-config.json.
2. Substitua https://your-deployed-server-url.com pela URL pública do seu servidor.
3. No Manus, vá para Conectores > MCP Personalizado e clique em Adicionar MCP Personalizado.
4. Selecione a opção de importar por JSON e cole o conteúdo do arquivo manus-mcp-config.json.

O servidor Pluggy estará disponível para uso em seus prompts.

6. Ferramentas MCP Disponíveis

A tabela abaixo descreve as tools expostas pelo servidor MCP.