Skip to main content
Glama
Harutalk Japanese Coach MCP

Harutalk Japanese Coach MCP

by devRonPark

하루톡 일본어 코치 MCP

한국어 카카오톡 문장을 자연스러운 일본어로 변환하고, 초급 학습자를 위한 발음·표현 설명·복습 카드·퀴즈를 제공하는 MCP 서버입니다.

문서

Related MCP server: Jisho MCP

설치

git clone https://github.com/your-repo/kakao-playmcp.git
cd kakao-playmcp
npm install
npm run build

환경 변수 설정

export ANTHROPIC_API_KEY=sk-ant-...

MCP 클라이언트 설정 (Claude Desktop 예시)

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "harutalk-japanese-coach": {
      "command": "node",
      "args": ["/absolute/path/to/kakao-playmcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

서버 직접 실행

ANTHROPIC_API_KEY=sk-ant-... node dist/index.js

제공 Tool 목록

translate_kakao_message

한국어 문장을 자연스러운 일본어로 변환합니다. 로마자 발음(Hepburn), 핵심 표현 분해, 말투별 대안 표현을 함께 반환합니다.

파라미터

타입

기본값

설명

korean_text

string

필수

번역할 한국어 문장

relationship

enum

unknown

상대방 관계 (friend/coworker/stranger 등)

tone

enum

natural

원하는 말투 (casual/polite/cute 등)

learner_level

enum

absolute_beginner

학습자 수준

correct_japanese_sentence

사용자가 작성한 일본어(또는 로마자) 문장을 교정하고 어색한 이유를 초급자 기준으로 설명합니다.

파라미터

타입

기본값

설명

user_sentence

string

필수

교정받을 문장

intended_meaning

string

-

의도한 의미 (선택)

learner_level

enum

absolute_beginner

학습자 수준

explain_expression

일본어 표현을 초급자가 이해하기 쉽게 설명합니다. 예문과 로마자 발음 포함.

파라미터

타입

기본값

설명

expression

string

필수

설명받을 일본어 표현

context

string

-

표현의 사용 맥락 (선택)

learner_level

enum

absolute_beginner

학습자 수준

create_review_card

표현을 복습 카드로 저장합니다. 저장된 카드는 퀴즈 생성에 활용됩니다.

파라미터

타입

설명

expression

string

일본어 표현

romanization

string

로마자 발음

korean_meaning

string

한국어 뜻

difficulty

enum

난이도 (easy/normal/hard)

generate_daily_quiz

저장된 복습 카드로 1분 퀴즈를 생성합니다.

파라미터

타입

기본값

설명

quiz_count

number

3

문제 수 (1~10)

focus

enum

mixed

출제 유형 (meaning/pronunciation/expression/grammar/mixed)

level

enum

absolute_beginner

학습자 수준

reveal_answers

boolean

false

정답 즉시 표시 여부

응답 포맷

모든 일본어 문장은 3단 구조로 반환됩니다:

今日ちょっと遅れそう。
(Kyou chotto okuresou.)
오늘 조금 늦을 것 같아.

라이선스

MIT

Available Tools

5 tools
correct_japanese_sentenceB

사용자가 직접 작성한 일본어 문장을 교정하고, 왜 어색한지 초급자 기준으로 설명합니다.

Inputs: user_sentence (required), tone, learner_level, intended_meaning.

create_review_cardC

배운 일본어 표현을 복습 카드로 저장합니다.

Inputs: expression (required), romanization (required), korean_meaning (required), context, +3 more.

explain_expressionB

일본어 표현을 초급 학습자 기준으로 설명합니다. 읽기, 로마자 발음, 뜻, 사용 상황, 예문을 제공합니다.

Inputs: expression (required), context, learner_level.

generate_daily_quizC

저장된 복습 카드를 바탕으로 1분 안에 풀 수 있는 퀴즈를 생성합니다.

Inputs: focus, level, quiz_count, reveal_answers.

translate_kakao_messageB

한국어 카카오톡 문장을 자연스러운 일본어로 변환합니다. 초급 학습자를 위해 로마자 발음, 한국어 뜻, 핵심 표현 설명을 함께 제공합니다.

Inputs: korean_text (required), tone, relationship, learner_level, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 5 tools

    Disambiguation4/5

    Tools have mostly distinct purposes: correcting sentences, saving cards, explaining expressions, generating quizzes, and translating from Korean. Minor potential overlap between 'correct_japanese_sentence' and 'explain_expression' as both involve explanations, but one is for user-written sentences and the other for given expressions.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with underscore_case: correct_japanese_sentence, create_review_card, explain_expression, generate_daily_quiz, translate_kakao_message.

    Tool Count5/5

    With 5 tools, the server is well-scoped for a language coach. The count is neither too few to be useful nor too many to be overwhelming.

    Completeness4/5

    The tool set covers core learning activities: correction, review storage, explanation, quiz generation, and translation. Missing features like vocabulary lists or pronunciation, but the domain is adequately covered for a beginner-focused coach with Korean translation.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides Japanese UX conventions as an MCP server to help AI generate correct Japanese UI elements like proper name order, furigana, phone formats, and polite language. It includes tools for form generation, validation, keigo suggestions, and cultural adaptation for developers building Japanese-facing products.
      6
      91 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables Japanese word lookup and search using the Jisho.org dictionary, providing tools to search entries and retrieve exact word definitions with JLPT levels and parts of speech.
      2
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time language translation for chat conversations, automatically detecting and translating messages between multiple languages while correcting Korean grammar and style before sending.
      1
      MIT