@wagnergpnc/charactercounter-mcp 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# Unicode Precision MCP: O Guardião da Escrita Exata para I.A.
+
+## O que é?
+O **Unicode Precision MCP** é um servidor de infraestrutura analítica projetado para fornecer a verdade absoluta sobre a dimensão espacial de qualquer texto. Ao contrário de contadores comuns, ele opera sob o rigor matemático do **Unicode 16.0** e o padrão **UAX #29**, tratando o texto não como uma sequência de bytes ou unidades de memória, mas como **Aglomerados de Grafemas Estendidos** — exatamente o que o olho humano enxerga.
+
+## Por que é Vital para I.A. de Escrita?
+Modelos de Linguagem (LLMs) são, por natureza, motores estatísticos de predição de tokens. Eles **não possuem consciência espacial**. 
+Quando você pede a uma I.A. para escrever "exatamente 100 caracteres" ou criar um título que caiba em um espaço visual restrito, ela falha sistematicamente ao encontrar:
+- **Emojis Complexos:** Um emoji de família pode valer 11 ou mais no contador da I.A., mas conta como apenas 1 visualmente.
+- **Acentuação Decomposta:** Sequências de caracteres que se unem visualmente confundem o cálculo de tokens da I.A.
+- **Limites Rígidos de UI:** Plataformas como Google Ads, Twitter ou meta-tags de SEO exigem precisão que a I.A. orgânica não consegue garantir sozinha.
+
+Este MCP atua como a **ferramenta de medição externa** (a "régua física") que permite à I.A. validar e corrigir sua própria saída em um loop de feedback perfeito.
+
+## O Diferencial: Rigor Analítico Humano
+- **Normalização NFC:** Unifica automaticamente strings decompostas antes do cálculo, garantindo que `é` seja sempre um único ponto de código, não importa como foi gerado.
+- **Conformidade UAX #29:** Diferencia o que é "unidade de código" do que é "caractere visual". Identifica tons de pele, junções de largura zero (ZWJ) e alfabetos complexos como uma única unidade visual.
+- **Payload Multi-Métrico:** Retorna simultaneamente Graphemes (visual), Code Points (lógico), UTF-16 (memória) e UTF-8 (disco).
+
+## Guia Universal de Instalação e Execução
+
+Para todas as plataformas, o servidor utiliza o protocolo **MCP nativo via Stdio**. O caminho do executável gerado é:
+`W:/Bitcurioso/unicode-mcp/build/index.js`
+
+### 1. Preparação (Build)
+Antes de configurar, garanta que o projeto está compilado:
+```bash
+cd W:/Bitcurioso/unicode-mcp
+npm install
+npm run build
+```
+
+---
+
+### 2. Configuração por Plataforma
+
+#### **Antigravity**
+1. Abra o arquivo `c:\Users\SERVIDOR\.gemini\antigravity\mcp_config.json`.
+2. Adicione a entrada `unicode-mcp` dentro do objeto `mcpServers`:
+```json
+"unicode-mcp": {
+  "command": "node",
+  "args": ["W:/Bitcurioso/unicode-mcp/build/index.js"]
+}
+```
+
+#### **Cursor / Codex**
+1. Vá em **Settings** > **Cursor Settings** > **Features** > **MCP Servers**.
+2. Clique em **+ Add New MCP Server**.
+3. Escolha o tipo **stdio**.
+4. Nome: `UnicodeChecker`
+5. Command: `node`
+6. Arguments: `W:/Bitcurioso/unicode-mcp/build/index.js`
+
+#### **Claude Code (CLI)**
+Adicione a configuração no seu arquivo de recursos ou no init do Claude Code:
+```bash
+claude mcp add unicode-mcp node W:/Bitcurioso/unicode-mcp/build/index.js
+```
+
+#### **Gemini CLI / Outros Clientes Go/Python**
+Configure o arquivo `config.yaml` ou `mcp_config.json` do respectivo cliente apontando para o binário do node:
+```yaml
+mcpServers:
+  unicode:
+    command: "node"
+    args: ["W:/Bitcurioso/unicode-mcp/build/index.js"]
+```
+
+#### **VS Code (via Cline / Roo Code / Claude Dev)**
+1. Abra as configurações da extensão (ícone de engrenagem no chat da extensão).
+2. Procure por **MCP Config** ou **Edit MCP Settings**.
+3. Adicione o JSON:
+```json
+{
+  "mcpServers": {
+    "unicode-mcp": {
+      "command": "node",
+      "args": ["W:/Bitcurioso/unicode-mcp/build/index.js"]
+    }
+  }
+}
+```
+
+---
+
+### 3. Como Rodar e Testar
+
+Uma vez configurado, o servidor será iniciado automaticamente pelo seu editor/cliente. Para testar:
+
+1. **Via Chat:** Pergunte ao Agente: *"Qual a contagem de grafemas de '👨‍👩‍👧‍👦'?"*
+2. **Via Prompt Sistêmico:** Integre o arquivo `system_prompt.md` nas instruções de projeto para que a I.A. use o servidor como validador automático de loop em tarefas de escrita.
+3. **Log de Erros:** O servidor emite logs detalhados via `stderr`. Se houver falha na conexão, verifique se o caminho do `index.js` está correto.
+
+
+---
+*Desenvolvido sob os preceitos de Engenharia de IA Sênior para o ecossistema Bitcurioso.*

package/build/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+// Configuração do Servidor MCP
+const server = new Server({
+    name: "unicode-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {}
+    }
+});
+// A Matriz Otimizada do Modelo Esquemático da Ferramenta de Análise
+const ToolInputSchema = z.object({
+    conteudo_textual: z.string().describe("A cadeia textual a ser analisada quantitativamente baseada em Unicode.")
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "contagem_exata_caracteres_unicode",
+                description: "Realiza a contagem milimétrica e algorítmica exata de uma cadeia textual (métrica visual humana e bytes).",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        conteudo_textual: {
+                            type: "string",
+                            description: "A cadeia textual a ser analisada"
+                        }
+                    },
+                    required: ["conteudo_textual"]
+                }
+            }
+        ]
+    };
+});
+// Manipulador de Execução da Ferramenta
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name !== "contagem_exata_caracteres_unicode") {
+        throw new Error(`Ferramenta desconhecida mapeada no roteador lógico: ${request.params.name}`);
+    }
+    try {
+        const { conteudo_textual } = ToolInputSchema.parse(request.params.arguments);
+        // Regra de Ouro de Higienização Inter-sistêmica de Normalização: 
+        // Equivalência de Composição Canônica Unicode na Forma 'NFC'
+        const normalizedText = conteudo_textual.normalize("NFC");
+        // Regra Absoluta da Segmentação Textual Estruturada (Diretriz Node.js)
+        // Utilizando ECMA Intl.Segmenter com granularidade focada em grafemas visuais (UAX #29)
+        const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+        const segments = Array.from(segmenter.segment(normalizedText));
+        // 1. referencial numérico visual primordial
+        const grapheme_clusters = segments.length;
+        // 2. registro algorítmico do modelo das métricas dos (code_points)
+        const code_points = [...normalizedText].length;
+        // 3. densidade total estruturada (utf16_units)
+        const utf16_units = normalizedText.length;
+        // 4. consumo absoluto em disco (utf8_bytes)
+        const utf8_bytes = Buffer.byteLength(normalizedText, 'utf8');
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        grapheme_clusters,
+                        code_points,
+                        utf16_units,
+                        utf8_bytes
+                    }, null, 2)
+                }]
+        };
+    }
+    catch (e) {
+        throw new Error(`Erro na computacao rigorosa do payload: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+// A Parametrização dos Modos Estritos de Escuta e Canais Físicos de Comunicação (Stdio)
+async function start() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Unicode MCP Server isolado e enraizado ativamente no host via transporte estrito StdioServerTransport.");
+}
+start().catch(error => {
+    console.error("Erro fatal durante escuta processual da topologia:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@wagnergpnc/charactercounter-mcp",
+  "version": "1.0.0",
+  "main": "build/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "wagnergpnc",
+  "license": "ISC",
+  "description": "Unicode character counter MCP server",
+  "files": [
+    "build"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
+  },
+  "type": "module",
+  "bin": {
+    "charactercounter-mcp": "./build/index.js"
+  }
+}