BeLikeNative MCP 서버

Claude Desktop, ChatGPT, Cursor 등과 같은 AI 클라이언트에 문법 검사, 글쓰기 개선, 번역 및 어조 조정 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

API 키가 필요하지 않습니다. 문법 및 스타일 검사는 로컬 규칙 기반 엔진을 사용합니다. 번역 및 어조 조정은 호스트 AI가 처리할 수 있도록 구조화된 프롬프트를 반환합니다.

도구

도구	설명	처리 방식
`check_grammar`	L1 인식 설명을 포함한 문법, 맞춤법 및 구두점 검사	로컬 규칙 기반 (50개 이상의 정규식 규칙)
`improve_writing`	스타일, 장황함, 수동태, 문장 길이에 대한 텍스트 분석	로컬 규칙 기반 + 스타일 가이드라인
`translate`	자연스럽고 유창한 결과물로 언어 간 텍스트 번역	호스트 AI를 위한 프롬프트 반환
`adjust_tone`	텍스트 어조 조정 (격식, 캐주얼, 전문적, 외교적 등)	호스트 AI를 위한 프롬프트 반환

사전 요구 사항

Node.js 18 이상

이것으로 충분합니다. API 키, 환경 변수, 외부 서비스가 필요 없습니다.

설치

cd mcp-server
pnpm install

독립 실행

pnpm start

이 서버는 stdio(stdin/stdout)를 통해 통신합니다. 대화형으로 실행하는 것이 아니라 MCP 클라이언트에 의해 실행되도록 설계되었습니다.

MCP 클라이언트 설정

Claude Desktop

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 추가하세요:

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

Claude Code

Claude Code MCP 설정에 추가하세요:

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

Cursor

Cursor MCP 설정(프로젝트 내 .cursor/mcp.json 또는 전역 ~/.cursor/mcp.json)에 추가하세요:

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

Windsurf / 기타 MCP 클라이언트

stdio 전송을 지원하는 모든 MCP 클라이언트는 이 서버를 사용할 수 있습니다. node src/index.mjs를 가리키도록 설정하세요. 환경 변수는 필요하지 않습니다.

도구 스키마

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)"
}

아키텍처

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)

전송: stdio (MCP 표준)
문법/스타일: 로컬 규칙 기반 엔진 (외부 API 호출 없음)
번역/어조: 호스트 AI 클라이언트가 처리할 구조화된 프롬프트 반환
로깅: 모든 로그는 stderr로 전송 (stdout은 MCP 프로토콜용으로 예약됨)
오류 처리: 충돌 없음 — 모든 오류는 구조화된 MCP 오류 응답으로 반환됨

작동 원리

핵심 통찰: MCP 도구는 이미 AI가 내장된 AI 클라이언트(Claude Desktop, Cursor 등)에 의해 호출됩니다. MCP 서버가 자체적으로 API를 호출할 필요가 없습니다.

check_grammar 및 improve_writing은 50개 이상의 정규식 기반 규칙을 사용하여 문법 오류, 맞춤법 실수, 스타일 문제, 수동태 및 문장 길이 문제를 감지합니다. 결과는 결정론적이며 즉각적입니다.
translate 및 adjust_tone은 진정한 AI 지능이 필요하므로, 호스트 AI가 직접 처리할 수 있는 가이드라인이 포함된 구조화된 프롬프트를 반환합니다. 이는 이중 API 호출보다 더 빠르고 저렴하며 안정적입니다.

코드 품질

이 서버는 NASA Power of 10 규칙을 따릅니다:

모든 함수는 60줄 미만
함수당 최소 2개의 단언(assertion)
모든 루프는 고정된 상한선을 가짐
전역 가변 상태 없음 (상수는 고정됨)
모든 반환 값은 검사됨
경고 제로

BeLikeNative 개발자 도구

이 도구는 비원어민 영어 사용자를 위한 AI 기반 글쓰기 도구인 BeLikeNative 생태계의 일부입니다.

도구	유형	설명
Grammar Check	GitHub Action	60개의 규칙과 L1 인식 통찰력을 갖춘 PR 문법 검사기
Writing Assistant	GitHub Action	글쓰기 품질 분석: 가독성, 구조, 명확성
i18n Checker	GitHub Action	국제화가 필요한 하드코딩된 문자열 찾기
Commit Lint	GitHub Action	커밋 메시지 문법, 형식 및 명확성 검사기
Website Grader	웹 도구	무료 웹사이트 성능 평가 도구

BeLikeNative Chrome 확장 프로그램 — 100개 이상의 언어, 15가지 어조, 15가지 스타일을 지원하는 AI 글쓰기 보조 도구입니다. 10,000명 이상의 사용자, 4.6점 평점.

라이선스

MIT

BeLikeNative Grammar Server