Atomic APIs

Servidor MCP AtomicAPIs

Um servidor Model Context Protocol (MCP) que expõe 17 ferramentas de micro-API de nível de produção para assistentes de IA. Construído com .NET 9 e o SDK oficial ModelContextProtocol.

O MCP permite que assistentes de IA como o Claude invoquem essas ferramentas nativamente durante a conversa — sem necessidade de requisições HTTP, chaves de API ou código boilerplate no lado do cliente.

Instalação Rápida

Instalação com um clique para Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "atomicapis": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/atomicapis-mcp-server/src"]
    }
  }
}

Instalação com um clique para Claude Code

claude mcp add atomicapis -- dotnet run --project /path/to/atomicapis-mcp-server/src

Instalação com um clique para Kiro

Ferramentas

Ferramenta	Método	Descrição
WebToMarkdownTools	ExtractMarkdown	Extrai qualquer URL e converte a página em Markdown limpo. Remove navegação, rodapé, scripts e HTML não essencial para minimizar tokens. Protegido contra SSRF com limite de página de 5MB.
EmailShieldTools	VerifyEmail	Verifica se um endereço de e-mail é descartável ou de um domínio temporário conhecido. Valida o formato, consulta uma lista de domínios selecionada e verifica registros MX via DNS.
TimezoneTools	ResolveTimezone	Converte latitude/longitude em dados completos de fuso horário, incluindo fuso IANA, offset UTC, status de horário de verão, hora local atual e próxima transição.
SchemaSniffTools	InferSchema	Detecta automaticamente o formato (JSON, CSV, XML) de um payload e infere seu esquema — nomes de campos, tipos, nulidade e aninhamento.
ProductSchemaTools	GenerateProductSchema	Gera dados estruturados JSON-LD de Produto para SEO. Produz tanto JSON-LD bruto quanto uma tag <script> pronta para incorporação.
CsvSurgeonTools	CleanCsv	Limpa, normaliza e remove duplicatas de dados CSV. Corrige codificação, normaliza cabeçalhos, colapsa espaços em branco, preenche/trunca linhas e, opcionalmente, normaliza formatos de data.
UtmLinkTools	CloakLink	Cria URLs de rastreamento com tags UTM mascaradas. Codifica parâmetros de campanha em um token curto e os decodifica de volta.
JsonRepairTools	RepairJson	Corrige JSON quebrado de saídas de LLM — vírgulas finais, chaves sem aspas, aspas simples, colchetes ausentes. Opcionalmente, valida contra um esquema JSON.
TokenCounterTools	CountTokens	Conta tokens para vários modelos de LLM (GPT-4, Claude, Llama, Mistral, Gemini). Estima custos, uso da janela de contexto e sinaliza quando o texto excede o limite do modelo.
EmailAuthGraderTools	GradeEmailAuth	Audita a configuração de autenticação de e-mail de um domínio: SPF, DKIM, DMARC, MTA-STS e BIMI. Retorna uma nota (A–F), pontuação e recomendações acionáveis.
PiiRedactorTools	RedactPii	Detecta e redige informações pessoais identificáveis em texto. Trata e-mails, SSNs, cartões de crédito, números de telefone, endereços IP, endereços físicos, datas de nascimento e URLs.
PhoneValidatorTools	ValidatePhone	Valida números de telefone internacionais em mais de 30 países. Retorna formato E.164, informações do país, tipo de número (celular/fixo) e saída formatada.
TaxIdValidatorTools	ValidateTaxId	Valida números de IVA e identificações fiscais para UE, EUA, Reino Unido, Austrália e Índia. Números de IVA da UE são verificados no serviço VIES quando disponível.
PromptInjectionTools	DetectPromptInjection	Pontua texto para tentativas de injeção de prompt e jailbreak. Usa correspondência de padrões e análise heurística em várias categorias de ataque. Retorna uma pontuação de risco (0–100) com trechos sinalizados.
SemanticSearchTools	SemanticSearch	Corresponde uma consulta de pesquisa a um catálogo de itens usando similaridade TF-IDF. Suporta correspondência difusa, expansão de sinônimos e ponderação configurável de títulos.
RelatedContentTools	FindRelatedContent	Encontra itens de conteúdo relacionados em um corpus usando similaridade TF-IDF e Jaccard. Limiares configuráveis, reforço de categorias e detalhamento opcional de pontuações.
VoiceTaskParserTools	ParseTasks	Extrai tarefas acionáveis de transcrições de voz. Identifica verbos de ação, responsáveis, prioridades, prazos e pontuações de confiança. Suporta até 100.000 caracteres.

Primeiros Passos

Pré-requisitos

• .NET 9 SDK

Compilar

cd src
dotnet build

Executar

cd src
dotnet run

O servidor se comunica via stdio usando o protocolo MCP JSON-RPC. Ele foi projetado para ser iniciado por um cliente compatível com MCP (por exemplo, Claude Desktop, Claude Code, Kiro ou qualquer host MCP). Consulte Instalação Rápida acima para configuração.

Arquitetura

src/
├── Program.cs              # MCP server entry point (stdio transport)
├── Tools/                  # MCP tool definitions (17 tools)
│   ├── WebToMarkdownTools.cs
│   ├── EmailShieldTools.cs
│   ├── TimezoneTools.cs
│   └── ...
└── Engines/                # Core logic (pure computation, no HTTP/DI concerns)
    ├── CsvCleaner.cs
    ├── SchemaInferrer.cs
    ├── EmailValidator.cs
    └── ...

Tools definem a interface MCP — descrições de parâmetros, validação e formatação de respostas. Cada ferramenta delega a uma classe Engine que contém a lógica de negócio pura, sem dependências de framework.

Dependências

Pacote	Versão	Finalidade
ModelContextProtocol	1.1.0	SDK MCP para .NET
Microsoft.Extensions.Hosting	9.0.6	Construtor de host para DI e ciclo de vida
HtmlAgilityPack	1.12.4	Análise de HTML (Web-to-Markdown)
ReverseMarkdown	5.2.0	Conversão de HTML para Markdown
GeoTimeZone	6.1.0	Consulta de coordenadas para fuso horário
DnsClient	1.8.0	Consultas DNS (avaliação de autenticação de e-mail)

Licença

MIT