
Security News
Open Source Maintainers Demand Ability to Block Copilot-Generated Issues and PRs
Open source maintainers are urging GitHub to let them block Copilot from submitting AI-generated issues and pull requests to their repositories.
mcp-server-bigboost
Advanced tools
Servidor MCP para integração com a API Bigboost da Bigdatacorp
Servidor MCP (Model Context Protocol) para integração com a API Bigboost da Bigdatacorp. Este servidor permite que modelos de linguagem como o Claude possam acessar dados da Bigboost API de forma padronizada, permitindo consultas de dados de pessoas físicas e empresas através de diferentes parâmetros de busca.
O servidor segue os padrões SOLID e SDR, com variáveis, classes e métodos em inglês usando camelCase, e índices no elasticsearch em inglês usando snake_case.
mcp-server-bigboost/
├── src/
│ ├── config/ # Configurações
│ ├── constants/ # Constantes
│ ├── services/ # Serviços
│ ├── tools/ # Ferramentas MCP
│ ├── types/ # Definições de tipos
│ ├── utils/ # Utilitários
│ ├── server.ts # Configuração do servidor
│ └── index.ts # Ponto de entrada
├── tests/ # Testes
├── .env.example # Exemplo de variáveis de ambiente
└── README.md # Documentação
npm install
.env.example
para .env
e configure suas credenciais:
cp .env.example .env
BIGBOOST_ACCESS_TOKEN=seu-access-token
BIGBOOST_TOKEN_ID=seu-token-id
O servidor MCP funciona exclusivamente no modo stdio, usado para integração direta com modelos de linguagem como o Claude:
npm start
Consulta dados básicos de uma pessoa física a partir do CPF.
Parâmetros:
cpf
: Número do CPF (com ou sem pontuação)Exemplo de uso:
// No Claude Desktop
const resultado = await mcp.consultaPessoa({ cpf: "${CPF_EXEMPLO}" });
// Em outros clientes MCP
const response = await fetch("http://localhost:3000/mcp", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
name: "consultaPessoa",
parameters: { cpf: "${CPF_EXEMPLO}" }
})
});
const resultado = await response.json();
Consulta dados básicos de uma pessoa física a partir do número de telefone.
Parâmetros:
telefone
: Número de telefone (com ou sem pontuação)Exemplo de uso:
// No Claude Desktop
const resultado = await mcp.consultaPessoaTelefone({ telefone: "${TELEFONE_EXEMPLO}" });
// Em outros clientes MCP
const response = await fetch("http://localhost:3000/mcp", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
name: "consultaPessoaTelefone",
parameters: { telefone: "${TELEFONE_EXEMPLO}" }
})
});
const resultado = await response.json();
Consulta dados básicos de uma pessoa física a partir do endereço de email.
Parâmetros:
email
: Endereço de email válidoExemplo de uso:
// No Claude Desktop
const resultado = await mcp.consultaPessoaEmail({ email: "${EMAIL_EXEMPLO}" });
// Em outros clientes MCP
const response = await fetch("http://localhost:3000/mcp", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
name: "consultaPessoaEmail",
parameters: { email: "${EMAIL_EXEMPLO}" }
})
});
const resultado = await response.json();
Consulta dados básicos de uma empresa a partir do CNPJ.
Parâmetros:
cnpj
: Número do CNPJ (com ou sem pontuação)Exemplo de uso:
// No Claude Desktop
const resultado = await mcp.consultaEmpresa({ cnpj: "${CNPJ_EXEMPLO}" });
// Em outros clientes MCP
const response = await fetch("http://localhost:3000/mcp", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
name: "consultaEmpresa",
parameters: { cnpj: "${CNPJ_EXEMPLO}" }
})
});
const resultado = await response.json();
Consulta o Quadro Societário e Administrativo (QSA) de uma empresa a partir do CNPJ.
Parâmetros:
cnpj
: Número do CNPJ (com ou sem pontuação)Exemplo de uso:
// No Claude Desktop
const resultado = await mcp.consultaQsa({ cnpj: "${CNPJ_EXEMPLO}" });
// Em outros clientes MCP
const response = await fetch("http://localhost:3000/mcp", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
name: "consultaQsa",
parameters: { cnpj: "${CNPJ_EXEMPLO}" }
})
});
const resultado = await response.json();
Consulta dados completos de registro de uma empresa a partir do CNPJ, incluindo endereços e contatos.
Parâmetros:
cnpj
: Número do CNPJ (com ou sem pontuação)Exemplo de uso:
// No Claude Desktop
const resultado = await mcp.consultaRegistroEmpresa({ cnpj: "${CNPJ_EXEMPLO}" });
// Em outros clientes MCP
const response = await fetch("http://localhost:3000/mcp", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
name: "consultaRegistroEmpresa",
parameters: { cnpj: "${CNPJ_EXEMPLO}" }
})
});
const resultado = await response.json();
npm run build
npm run dev
Se você encontrar erros relacionados ao pacote @modelcontextprotocol/sdk
, como:
Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in node_modules/@modelcontextprotocol/sdk/package.json
ou
Cannot find module '@modelcontextprotocol/sdk' or its corresponding type declarations
Tente as seguintes soluções:
Usar uma versão específica do Node.js (recomendado: v18.x):
nvm use 18
Reinstalar o pacote MCP SDK:
npm uninstall @modelcontextprotocol/sdk
npm install @modelcontextprotocol/sdk@1.10.0
Limpar o cache do npm:
npm cache clean --force
rm -rf node_modules
npm install
npm test
npm run lint
Para utilizar este servidor com o Windsurf (Claude Desktop), você precisa configurá-lo no arquivo mcp_config.json
:
Instale o pacote do servidor:
npm install -g mcp-server-bigboost
Adicione a configuração ao arquivo ~/.codeium/windsurf/mcp_config.json
:
{
"mcpServers": {
"bigboost-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-server-bigboost"
],
"env": {
"BIGBOOST_ACCESS_TOKEN": "seu-access-token",
"BIGBOOST_TOKEN_ID": "seu-token-id"
}
}
}
}
Reinicie o Windsurf para que as alterações sejam aplicadas.
Utilize as ferramentas diretamente no prompt do Claude:
Por favor, consulte o CPF ${CPF_EXEMPLO} usando a ferramenta consultaPessoa.
Para utilizar este servidor com o Claude ou outros modelos de linguagem:
Inicie o servidor:
npm start
Configure o Claude para usar o servidor como uma ferramenta externa via MCP:
Usuário: Consulte o CPF ${CPF_EXEMPLO} para mim.
Claude: Vou consultar esse CPF para você usando a ferramenta consultaPessoa.
[Claude usa a ferramenta consultaPessoa com o parâmetro CPF]
Aqui estão os resultados da consulta para o CPF ${CPF_EXEMPLO}:
Nome: João da Silva
Data de Nascimento: 15/05/1980
Situação do CPF: Regular
...
O servidor MCP retorna os códigos de status da API Bigboost no campo status
da resposta. Verifique sempre este campo para garantir que a consulta foi bem-sucedida.
Exemplo de resposta com sucesso:
{
"result": [...],
"status": {
"doc_finder": [
{
"Code": 0,
"Message": "OK"
}
],
"basic_data": [
{
"Code": 0,
"Message": "OK"
}
]
},
"queryId": "...",
"elapsedMilliseconds": 123,
"queryDate": "..."
}
FAQs
Servidor MCP para integração com a API Bigboost da Bigdatacorp
The npm package mcp-server-bigboost receives a total of 34 weekly downloads. As such, mcp-server-bigboost popularity was classified as not popular.
We found that mcp-server-bigboost demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Open source maintainers are urging GitHub to let them block Copilot from submitting AI-generated issues and pull requests to their repositories.
Research
Security News
Malicious Koishi plugin silently exfiltrates messages with hex strings to a hardcoded QQ account, exposing secrets in chatbots across platforms.
Research
Security News
Malicious PyPI checkers validate stolen emails against TikTok and Instagram APIs, enabling targeted account attacks and dark web credential sales.