yahoo-furigana-mcp
Adds furigana (reading) to Japanese text using Yahoo! JAPAN's Furigana API, supporting multiple output formats like HTML ruby, brackets, and roman.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.