@wagnergpnc/charactercounter-mcp 1.0.0 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +103 -97
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,97 +1,103 @@
1
- # Unicode Precision MCP: O Guardião da Escrita Exata para I.A.
2
-
3
- ## O que é?
4
- 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.
5
-
6
- ## Por que é Vital para I.A. de Escrita?
7
- Modelos de Linguagem (LLMs) são, por natureza, motores estatísticos de predição de tokens. Eles **não possuem consciência espacial**.
8
- 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:
9
- - **Emojis Complexos:** Um emoji de família pode valer 11 ou mais no contador da I.A., mas conta como apenas 1 visualmente.
10
- - **Acentuação Decomposta:** Sequências de caracteres que se unem visualmente confundem o cálculo de tokens da I.A.
11
- - **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.
12
-
13
- 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.
14
-
15
- ## O Diferencial: Rigor Analítico Humano
16
- - **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.
17
- - **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.
18
- - **Payload Multi-Métrico:** Retorna simultaneamente Graphemes (visual), Code Points (lógico), UTF-16 (memória) e UTF-8 (disco).
19
-
20
- ## Guia Universal de Instalação e Execução
21
-
22
- Para todas as plataformas, o servidor utiliza o protocolo **MCP nativo via Stdio**. O caminho do executável gerado é:
23
- `W:/Bitcurioso/unicode-mcp/build/index.js`
24
-
25
- ### 1. Preparação (Build)
26
- Antes de configurar, garanta que o projeto está compilado:
27
- ```bash
28
- cd W:/Bitcurioso/unicode-mcp
29
- npm install
30
- npm run build
31
- ```
32
-
33
- ---
34
-
35
- ### 2. Configuração por Plataforma
36
-
37
- #### **Antigravity**
38
- 1. Abra o arquivo `c:\Users\SERVIDOR\.gemini\antigravity\mcp_config.json`.
39
- 2. Adicione a entrada `unicode-mcp` dentro do objeto `mcpServers`:
40
- ```json
41
- "unicode-mcp": {
42
- "command": "node",
43
- "args": ["W:/Bitcurioso/unicode-mcp/build/index.js"]
44
- }
45
- ```
46
-
47
- #### **Cursor / Codex**
48
- 1. Vá em **Settings** > **Cursor Settings** > **Features** > **MCP Servers**.
49
- 2. Clique em **+ Add New MCP Server**.
50
- 3. Escolha o tipo **stdio**.
51
- 4. Nome: `UnicodeChecker`
52
- 5. Command: `node`
53
- 6. Arguments: `W:/Bitcurioso/unicode-mcp/build/index.js`
54
-
55
- #### **Claude Code (CLI)**
56
- Adicione a configuração no seu arquivo de recursos ou no init do Claude Code:
57
- ```bash
58
- claude mcp add unicode-mcp node W:/Bitcurioso/unicode-mcp/build/index.js
59
- ```
60
-
61
- #### **Gemini CLI / Outros Clientes Go/Python**
62
- Configure o arquivo `config.yaml` ou `mcp_config.json` do respectivo cliente apontando para o binário do node:
63
- ```yaml
64
- mcpServers:
65
- unicode:
66
- command: "node"
67
- args: ["W:/Bitcurioso/unicode-mcp/build/index.js"]
68
- ```
69
-
70
- #### **VS Code (via Cline / Roo Code / Claude Dev)**
71
- 1. Abra as configurações da extensão (ícone de engrenagem no chat da extensão).
72
- 2. Procure por **MCP Config** ou **Edit MCP Settings**.
73
- 3. Adicione o JSON:
74
- ```json
75
- {
76
- "mcpServers": {
77
- "unicode-mcp": {
78
- "command": "node",
79
- "args": ["W:/Bitcurioso/unicode-mcp/build/index.js"]
80
- }
81
- }
82
- }
83
- ```
84
-
85
- ---
86
-
87
- ### 3. Como Rodar e Testar
88
-
89
- Uma vez configurado, o servidor será iniciado automaticamente pelo seu editor/cliente. Para testar:
90
-
91
- 1. **Via Chat:** Pergunte ao Agente: *"Qual a contagem de grafemas de '👨‍👩‍👧‍👦'?"*
92
- 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.
93
- 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.
94
-
95
-
96
- ---
97
- *Desenvolvido sob os preceitos de Engenharia de IA Sênior para o ecossistema Bitcurioso.*
1
+ # Unicode Precision MCP: O Guardião da Escrita Exata para I.A.
2
+
3
+ ## O que é?
4
+ 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.
5
+
6
+ ## Por que é Vital para I.A. de Escrita?
7
+ Modelos de Linguagem (LLMs) são, por natureza, motores estatísticos de predição de tokens. Eles **não possuem consciência espacial**.
8
+ 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:
9
+ - **Emojis Complexos:** Um emoji de família pode valer 11 ou mais no contador da I.A., mas conta como apenas 1 visualmente.
10
+ - **Acentuação Decomposta:** Sequências de caracteres que se unem visualmente confundem o cálculo de tokens da I.A.
11
+ - **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.
12
+
13
+ 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.
14
+
15
+ ## O Diferencial: Rigor Analítico Humano
16
+ - **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.
17
+ - **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.
18
+ - **Payload Multi-Métrico:** Retorna simultaneamente Graphemes (visual), Code Points (lógico), UTF-16 (memória) e UTF-8 (disco).
19
+
20
+ ## Guia Universal de Instalação e Execução
21
+
22
+ Para todas as plataformas, o servidor utiliza o protocolo **MCP nativo via Stdio**, alimentado pela execução instantânea em nuvem (`npx`). Não é necessário instalar ou clonar nada localmente.
23
+
24
+ ### 1. Requisito
25
+ Somente é necessário possuir o **Node.js/npm** instalado na sua máquina. O comando `npx` cuidará de baixar e rodar as engrenagens em segundo plano.
26
+
27
+ ---
28
+
29
+ ### 2. Configuração por Plataforma
30
+
31
+ #### **Antigravity**
32
+ 1. Abra o arquivo de configuração `mcp_config.json`.
33
+ 2. Adicione a entrada `unicode-mcp` dentro do objeto `mcpServers`:
34
+ ```json
35
+ "unicode-mcp": {
36
+ "command": "npx",
37
+ "args": ["-y", "@wagnergpnc/charactercounter-mcp"]
38
+ }
39
+ ```
40
+
41
+ #### **Cursor**
42
+ 1. Vá em **Settings** > **Cursor Settings** > **Features** > **MCP Servers**.
43
+ 2. Clique em **+ Add New MCP Server**.
44
+ 3. Escolha o tipo **stdio**.
45
+ 4. Nome: `UnicodeChecker`
46
+ 5. Command: `npx`
47
+ 6. Arguments: `-y @wagnergpnc/charactercounter-mcp`
48
+
49
+ #### **Claude Code / Codex / Gemini CLI**
50
+ Para IAs e assistentes operados puramente via terminal, os comandos de instalação injetam o provedor MCP imediatamente:
51
+
52
+ **Claude Code:**
53
+ ```bash
54
+ claude mcp add unicode-mcp npx -y @wagnergpnc/charactercounter-mcp
55
+ ```
56
+
57
+ **Codex:**
58
+ ```bash
59
+ codex mcp add unicode-mcp -- npx -y @wagnergpnc/charactercounter-mcp
60
+ ```
61
+
62
+ **Gemini CLI:**
63
+ ```bash
64
+ gemini mcp add unicode-mcp npx -y @wagnergpnc/charactercounter-mcp
65
+ ```
66
+
67
+ #### **Outros Clientes Go/Python**
68
+ Se o cliente usa configuração em arquivo `yaml/json` não gerada via CLI:
69
+ ```yaml
70
+ mcpServers:
71
+ unicode:
72
+ command: "npx"
73
+ args: ["-y", "@wagnergpnc/charactercounter-mcp"]
74
+ ```
75
+
76
+ #### **VS Code (via Cline / Roo Code / Claude Dev)**
77
+ 1. Abra as configurações da extensão (ícone de engrenagem no chat da extensão).
78
+ 2. Procure por **MCP Config** ou **Edit MCP Settings**.
79
+ 3. Adicione o JSON:
80
+ ```json
81
+ {
82
+ "mcpServers": {
83
+ "unicode-mcp": {
84
+ "command": "npx",
85
+ "args": ["-y", "@wagnergpnc/charactercounter-mcp"]
86
+ }
87
+ }
88
+ }
89
+ ```
90
+
91
+ ---
92
+
93
+ ### 3. Como Rodar e Testar
94
+
95
+ Uma vez configurado, o servidor será iniciado automaticamente pelo seu editor/cliente. Para testar:
96
+
97
+ 1. **Via Chat:** Pergunte ao Agente: *"Qual a contagem de grafemas de '👨‍👩‍👧‍👦'?"*
98
+ 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.
99
+ 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.
100
+
101
+
102
+ ---
103
+ *Desenvolvido sob os preceitos de Engenharia de IA Sênior para o ecossistema Bitcurioso.*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wagnergpnc/charactercounter-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.0.4",
4
4
  "main": "build/index.js",
5
5
  "scripts": {
6
6
  "test": "echo \"Error: no test specified\" && exit 1",