Yahoo! ふりがな API MCP サーバ

Yahoo! JAPAN テキスト解析のふりがなAPI（V2）を利用したMCPサーバです。

日本語テキストにふりがな（ひらがな読み）やローマ字を付けることができます。

必要な環境

• Node.js 18以上
• Yahoo! JAPAN デベロッパーネットワークの Client ID（アプリケーションID）
  • Yahoo! ID連携 v2 アプリケーションの登録から取得できます

セットアップ

1. 依存関係のインストール

npm install

2. ビルド

npm run build

Claude Desktop での設定

方法1: npx経由で実行（推奨）

ローカルにリポジトリを配置せず、npm経由で実行する方法です。

claude_desktop_config.json に以下を追加してください：

{
  "mcpServers": {
    "yahoo-furigana": {
      "command": "npx",
      "args": ["-y", "yahoo-furigana-mcp"],
      "env": {
        "YAHOO_CLIENT_ID": "あなたのClient ID"
      }
    }
  }
}

方法2: ローカルから実行

リポジトリをクローンして実行する方法です。

claude_desktop_config.json に以下を追加してください：

{
  "mcpServers": {
    "yahoo-furigana": {
      "command": "node",
      "args": ["/path/to/yahoo-furigana-mcp/dist/index.js"],
      "env": {
        "YAHOO_CLIENT_ID": "あなたのClient ID"
      }
    }
  }
}

/path/to/yahoo-furigana-mcp は実際のパスに置き換えてください。

提供するツール

gen_furigana

日本語テキストにふりがなを付けます。

パラメータ

| 名前 | 型 | 必須 | 説明 | |------|-----|------|------| | text | string | ○ | ふりがなを付けたい日本語テキスト | | grade | number | - | 学年指定（1-8）。指定した学年までに習う漢字にはふりがなを付けません | | output_format | string | - | 出力形式（デフォルト: ruby） |

output_format の値

| 値 | 説明 | 出力例 | |----|------|--------| | ruby | HTMLルビ形式（デフォルト） | <ruby>漢字<rt>かんじ</rt></ruby> | | bracket | 括弧形式 | 漢字（かんじ） | | roman | ローマ字付き詳細形式 | 漢字: かんじ (kanji) |

grade の値

| 値 | 対象 | |----|------| | 1 | 小学1年生までに習う漢字 | | 2 | 小学2年生までに習う漢字 | | 3 | 小学3年生までに習う漢字 | | 4 | 小学4年生までに習う漢字 | | 5 | 小学5年生までに習う漢字 | | 6 | 小学6年生までに習う漢字 | | 7 | 中学生までに習う漢字 | | 8 | それ以上 |

使用例

ruby形式（デフォルト）:

入力: "漢字の読み方"
出力: "<ruby>漢字<rt>かんじ</rt></ruby>の<ruby>読<rt>よ</rt></ruby>み<ruby>方<rt>かた</rt></ruby>"

bracket形式:

入力: "漢字の読み方を教えてください"
出力: "漢字（かんじ）の読（よ）み方（かた）を教（おし）えてください"

特徴

• 自動チャンク分割: 4KBを超える長いテキストも自動的に分割して処理します。文の区切り（。！？など）で分割するため、自然な結果が得られます。

npm公開（開発者向け）

このパッケージをnpmに公開する手順：

# ビルド
npm run build

# パッケージの内容を確認
npm pack --dry-run

# npmにログイン（初回のみ）
npm login

# 公開
npm publish

公開後、ユーザーは npx yahoo-furigana-mcp でローカルにリポジトリを配置せずに利用できます。

制限事項

• Yahoo! JAPAN APIの利用規約に従ってください

ライセンス

MIT