Servidor MCP BeLikeNative

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas de corrección gramatical, mejora de escritura, traducción y ajuste de tono a clientes de IA como Claude Desktop, ChatGPT, Cursor y otros.

No se requiere clave API. Las comprobaciones de gramática y estilo utilizan un motor local basado en reglas. La traducción y el ajuste de tono devuelven prompts estructurados para que la IA anfitriona los procese.

Herramientas

Requisitos previos

• Node.js 18+

Eso es todo. Sin claves API, sin variables de entorno, sin servicios externos.

Instalación

cd mcp-server
pnpm install

Ejecución independiente

pnpm start

El servidor se comunica a través de stdio (stdin/stdout). Está diseñado para ser iniciado por un cliente MCP, no para ejecutarse de forma interactiva.

Configuración del cliente MCP

Claude Desktop

Añadir a la configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "belikenative": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/src/index.mjs"]
    }
  }
}

Claude Code

Añadir a la configuración MCP de Claude Code:

{
  "mcpServers": {
    "belikenative": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/src/index.mjs"]
    }
  }
}

Cursor

Añadir a la configuración MCP de Cursor (.cursor/mcp.json en tu proyecto o ~/.cursor/mcp.json globalmente):

{
  "mcpServers": {
    "belikenative": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/src/index.mjs"]
    }
  }
}

Windsurf / Otros clientes MCP

Cualquier cliente MCP que admita transporte stdio puede usar este servidor. Apúntalo a node src/index.mjs. No se necesitan variables de entorno.

Esquemas de herramientas

check_grammar

{
  "text": "string (required, max 6000 chars)",
  "language": "string (optional, default 'en') -- writer's native language for L1-tailored explanations"
}

improve_writing

{
  "text": "string (required, max 6000 chars)",
  "style": "enum: academic | business | creative | technical | simple | concise (optional, default 'business')"
}

translate

{
  "text": "string (required, max 6000 chars)",
  "source_language": "string (required) -- e.g. 'en', 'English', 'fr'",
  "target_language": "string (required) -- e.g. 'es', 'Spanish', 'de'"
}

adjust_tone

{
  "text": "string (required, max 6000 chars)",
  "tone": "enum: formal | casual | friendly | professional | persuasive | confident | empathetic | diplomatic (required)"
}

Arquitectura

src/
  index.mjs    -- MCP server entry point (stdio transport, tool registration)
  tools.mjs    -- Tool definitions (JSON schemas) and handler functions
  rules.mjs    -- Local grammar rules engine (50+ regex patterns, style analyzer)

• Transporte: stdio (estándar para MCP)

• Gramática/Estilo: Motor local basado en reglas (sin llamadas a API externas)

• Traducción/Tono: Devuelve prompts estructurados para que el cliente de IA anfitrión los procese

• Registro: Todos los registros van a stderr (stdout está reservado para el protocolo MCP)

• Gestión de errores: Nunca se bloquea: todos los errores devuelven respuestas de error MCP estructuradas

Cómo funciona

La idea clave: las herramientas MCP son llamadas por clientes de IA (Claude Desktop, Cursor, etc.) que ya tienen IA integrada. No hay necesidad de que el servidor MCP realice sus propias llamadas a la API.

• check_grammar y improve_writing utilizan más de 50 reglas basadas en regex para detectar errores gramaticales, faltas de ortografía, problemas de estilo, voz pasiva y problemas de longitud de frases. Los resultados son deterministas e instantáneos.

• translate y adjust_tone requieren realmente inteligencia artificial, por lo que devuelven prompts estructurados con pautas que la IA anfitriona procesa directamente. Esto es más rápido, más barato y más fiable que una doble llamada a la API.

Calidad del código

Este servidor sigue las reglas "Power of 10" de la NASA:

• Todas las funciones tienen menos de 60 líneas

• Mínimo 2 aserciones por función

• Todos los bucles tienen límites superiores fijos

• Sin estado mutable global (las constantes están congeladas)

• Se comprueba cada valor de retorno

• Cero advertencias

Herramientas para desarrolladores de BeLikeNative

Esta herramienta es parte del ecosistema BeLikeNative: herramientas de escritura impulsadas por IA para hablantes no nativos de inglés.

Extensión de Chrome BeLikeNative — Asistente de escritura con IA para más de 100 idiomas, 15 tonos, 15 estilos. Más de 10.000 usuarios, calificación de 4.6★.

Licencia

MIT