Yahoo! ふりがな API MCP サーバ

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

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

必要な環境

• Node.js 18以上

• Yahoo! JAPAN デベロッパーネットワークの Client ID（アプリケーションID）

  • Yahoo! ID連携 v2 アプリケーションの登録から取得できます

Related MCP server: Yomitan MCP Server

セットアップ

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

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

パラメータ

output_format の値

grade の値

使用例

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