Inoh

inoh-mcp

Inoh 向けのリモート MCP サーバーです。Inoh は、言葉を巧みに操る人のための語彙アプリです。Claude、ChatGPT、Cursor、または MCP 対応のクライアントに接続すると、会話中に AI が Inoh の辞書で単語を調べたり、あなたのアカウントにフラッシュカードを作成したりできます。

記事で見かけたばかりの単語を尋ねると、定義、例文、音声、画像、クイズの選択肢を備えたカードが作られ、スマートフォンの Inoh アプリですぐに復習できます。

単語は複数のデッキに登録できます。復習の進捗は共有され、デッキごとの登録はアカウントのプラン上限に対してそれぞれ 1 枚のカードとして数えられます。別のデッキにも登録されている場合、あるデッキから削除しても進捗は保持されます。このサーバーをデプロイする前に、関連する inoh-backend のマイグレーションをデプロイしてください。

https://mcp.inoh.app/mcp

接続

無料の Inoh アカウントが必要です。サインインは Inoh の通常のメール認証フローを通じてブラウザーで行われるため、AI クライアントにパスワードが渡ることはありません。また、Inoh アカウントの設定からいつでもアクセスを取り消せます。

Claude、Cursor、ChatGPT、Gemini、VS Code などの手順については、docs.inoh.app をご覧ください。接続先アドレスとトラブルシューティングは、docs/installation.md にも記載されています。

Grok Bot プラグイン

Inoh プラグインには、ホスト型 MCP 接続と Grok Bot 用の語彙スキルが含まれています。Cursor のプラグイン形式とマーケットプレイスを使用します。マニフェストにサーバーアドレスが記載されているため、ユーザーはプラグインのブラウザーサインインフローを通じて接続できます。ルートの .cursor-plugin/marketplace.json は、plugins/grok-bot/ にある単独のパッケージを参照しています。プラグインパッケージは plugins/ 内で対象クライアントごとに整理されており、いずれのパッケージも同じホスト型 MCP サーバーに接続します。

このプラグインは MIT ライセンスで、まだ掲載されていません。掲載には、サインイン済みクライアントでのテストとマーケットプレイスの審査が必要です。手順と公開者フォームの入力値については、公開とテストをご覧ください。

できること

ツール	機能
search_dictionary	公開辞書や自分のカードから、単語やフレーズを検索します
search_deck	複数のデッキ、または指定したデッキから、すでに持っている単語を検索します
browse_deck	検索語を指定せずに、デッキから単語を取り出します
record_review	復習中に単語をどれだけ覚えていたかを記録します
add_card_to_deck	すでにあるカードをデッキに追加します
remove_card_from_deck	カード自体は残したまま、デッキからカードを取り除きます
create_private_card	単語のフラッシュカードを一式作成して、デッキに保存します
update_private_card	復習の進捗を保ったまま、自分で作成したカードを作り直します
request_public_card	共有辞書に単語を追加するよう依頼します
check_card_status	カードや自分が行ったリクエストの状況を確認します
delete_private_card	自分で作成したカードを完全に削除します
check_account	サインイン中の Inoh アカウントを表示します

実際によくあるリクエスト：

• 「serendipity を Inoh のデッキに追加して。」
• 「スタートアップ関連の記事で runway をよく見かける。この意味のカードを作って。空港の意味じゃなくて。」
• 「あの記事で間違えた単語のカードを全部作って。」
• 「platitudinous のカードはもうできた？」
• 「serendipity はもうデッキにある？」
• 「デッキからランダムに単語を10個出して。」
• 「最近デッキに何を追加した？」
• 「今日は何を復習すればいい？」
• 「今日の単語をクイズにして。」
• 「何度も忘れてしまう単語はどれ？」
• 「デッキに get を使った句動詞はある？」
• 「banyan をデッキから外して。もう覚えたから。」
• 「moat のカードの説明が違う意味になっている。ビジネスの意味で作り直して。」
• 「runway のカードの画像は役に立たない。カードを作り直して。」
• 「さっき自分で作った moat のカードを削除して。」
• 「banyan のカードをデッキに戻して。」
• 「Inoh には enshittification がない。みんなの辞書に追加してもらえる？」
• 「提案したあの単語、辞書に追加された？」

単語を指定すると、AI はまず辞書を検索します。Inoh に公開辞書のカードがすでにあればそのカードを追加し、なければ新しいカードを生成します。

search_deck は、追加できる単語ではなく、すでに持っている単語を検索します。そのため、「これはもう持っている？」という質問に答える際、辞書の45,000件の項目に自分のカードが埋もれることはありません。アプリの検索と同じように入力ミスも許容し、その単語がどのデッキにあるかも知らせます。

検索する単語がないときは、browse_deck を使います。ランダムにいくつか出すよう頼むと、そのたびに異なる単語が選ばれます。新しい順、または古い順に頼むと、追加した順に表示されます。復習する単語を尋ねると、アプリが出題するのと同じように、今日の復習セッションが表示されます。新しいカードと、あなたの一日の終わりまでに復習予定の単語が含まれます。何度も忘れてしまう単語を尋ねると、復習で間違えたカードが、間違いの多いものから順に表示されます。この方法でデッキを確認しても、カードの復習スケジュールには影響しません。

会話の中で復習する

AI に復習を頼んだり、デッキを一緒に確認したり、クイズを出してもらったりすると、追加確認なしで今日のセッションが始まります。会話に合わせてセッションを進めます。単語を示して意味を尋ねたり、意味を伝えて単語を尋ねたり、文の中で使ったりします。回答のたびに、どれだけ覚えていたか（覚えていた、少し覚えていた、覚えていなかった）を判定し、すぐに record_review で記録するので、途中でやめても記録が失われることはありません。

ここでの復習は、アプリでの復習とまったく同じようにカウントされます。同じルールで単語の次回復習日が設定され、次の復習時期が来るまで再び出題されることはありません。今日の連続記録の目標は、すべてのデッキとクライアントを通じて異なる単語を10個復習することです。復習できる単語が10個未満の場合は、復習可能な単語をすべて復習します。新しいカードはすぐに復習できます。単語が1つだけのデッキでセッションを行っても、ほかのデッキに復習する単語が残っている場合、目標は達成されません。MCP サーバーは回答ごとに目標の進捗状況を報告し、単語が残っていれば次のセッションを提案します。

復習できる単語がない場合、既存の連続記録は同じ数のまま維持されます。サーバーはそのことを伝え、任意の練習としてランダムな単語を提案します。この練習によって連続記録が伸びることはありません。

1回のセッションは最大10単語で、アプリが出題するセッションと同じです。新しい単語がある場合は少なくとも3個を含め、残りは予定された単語から選びます。復習予定の単語が20個を超えている間は新しい単語を出題しないため、遅れを取り戻してから新しい単語に進めます。目標を達成した後も、復習できる単語が残っていれば、次のセッションを開始できます。

週間利用枠

プランには、MCP ツール呼び出しの週間利用枠が含まれています。ツール呼び出しとは、AI アシスタントが Inoh で代わりに行う操作1回分のことです。たとえば、回答の記録や単語の追加、検索などが該当します。今日のセッションの開始と、現在サインインしているアカウントの確認は無料なので、単語10個のセッションでは10回分を使います。利用枠を使い切ると、今日のセッションも出題されません。利用枠は、お住まいの地域の月曜日の午前0時にリセットされます。

プラン	週あたりのツール呼び出し数	目安
Free	35	週3回の復習セッション、呼び出し5回分の余裕あり
Plus	100	週10回の復習セッション
Pro	500	週50回の復習セッション（1日あたり約7回）

追加、検索、閲覧にもツール呼び出しを使います。残りが少なくなると AI がそのことを知らせ、使い切ると、利用枠がいつ戻るかとアップグレード方法を案内します。

削除とデッキからの除外の違い

この2つは異なる操作で、ツールでも区別されています。

デッキからの除外は、カードの復習を終了するだけで、それ以上のことは起きません。公開辞書のカードは Inoh に残り、ほかのユーザーも引き続き利用できます。自分で作成したカードは、自分のプライベート辞書に残ります。いずれの場合も、いつでもカードを再追加できますが、復習の進捗は最初からやり直しになります。公開カード、自作カードのどちらにも、この操作には remove_card_from_deck を使用します。

削除は自分で作成したカードにのみ適用され、取り消せません。カードはプライベート辞書から削除され、画像や音声も一緒に消去されます。元に戻すことはできません。後で同じ単語を再度依頼すると、毎月の利用枠をもう一度使って新しいカードが作成されるため、AI は削除する前に確認します。カードが不要なのではなく、単に内容が間違っている場合は、update_private_card を使うと、復習の進捗を維持したままカードをその場で作り直せます。

作成したカード

ここで作成したカードは、あなただけのものです。あなただけが見られるプライベート辞書に追加され、公開されている Inoh の辞書には加わらず、ほかの人のフィードや検索結果にも表示されません。同じ単語を2人がリクエストした場合も、それぞれに専用のカードが作成されます。

仮のカードではなく、定義、例文、3つの音声クリップ、画像、発音記号、そして2種類のクイズの選択肢がすべてそろったカードです。そのため、カードが表示されたらすぐに、公開辞書のカードと並べてアプリで復習できます。また、アプリの「辞書」タブの「プライベート」に、あなたのカードとしてバッジ付きで表示されます。作成にかかる時間は約20秒です。

単語に複数の意味がある場合は、どの意味を指しているのか AI に伝えてください。「Runway」は、手持ち資金が尽きるまでの期間という意味と、空港の滑走路という意味では別のカードになります。また、生成された内容は、あなたに届く前に誰かが確認することはありません。

Inoh にその単語がすでにある場合、または以前に自分でカードを作成したことがある場合は、生成が始まる前に停止し、そのカードを案内します。公開辞書のカードは Inoh が作成・確認したもので、追加しても月ごとの上限にはカウントされません。そのため、ほとんどの場合は公開辞書のカードを選ぶのがよいでしょう。既存のカードではカバーされていない意味について、自分専用のカードが本当に必要な場合は、その旨を伝えれば AI が生成を進めます。

作成できるカードの枚数（暦月ごと）：

プラン	月ごとのカード枚数
Free	50
Plus	300
Pro	1,000

カードの内容が間違っていた場合

削除するのではなく、もう一度生成を依頼してください。update_private_card は、定義、例文、画像、音声、クイズの選択肢を再生成し、同じカードに上書きします。そのため、カードはデッキ内の位置を保ち、あなたの記憶の定着度について Inoh が把握している情報もすべて維持されます。削除して作り直すと、それらが失われ、単語を最初からやり直すことになります。

どの意味を指していたのか伝えれば、その意味に合わせて再生成します。何も伝えなければ、すでに設定されている意味で再生成を試みます。意味は合っていたものの、例文が平凡だったり、画像が役に立たなかったりした場合は、こちらが適しています。

新しい画像を生成するため、再生成には月ごとの上限からカード1枚分が差し引かれます。画像はカードの作成で最もコストがかかる部分です。カードで学習する単語自体は変更できません。別の単語にするには別のカードが必要なので、このカードを削除して、新しいカードを作成してください。

削除

カードを削除すると、カード本体、デッキ内の位置、画像、音声ファイルが完全に削除されます。使用した月ごとの上限は戻りません。Inoh アプリ内のデッキから自分のカードを削除した場合も、取り消し可能な時間が過ぎると、数分後にカードが削除されます。

公開辞書への投稿

上記はすべて、自分専用のカードについてです。すべての Inoh ユーザーが共有する 45,000 件のエントリーを収録した公開辞書も重要な要素で、そこに追加できます。辞書に単語を載せるべきだと思ったら、AI に頼めば、説明した語義とともに投稿してくれます。

その後の流れは、自分専用のカードを作る場合とは大きく異なります。公開する前に、Inoh の担当者が内容を確認します。 Inoh が通常どおりカードを作成した後、レビュアーの確認を待つため、所要時間は 1 分ではなく数日で、却下されることもあります。公開されたカードは Inoh の全ユーザーが利用できるようになり、あなたのデッキにも追加されるため、自分の提案を待たずにその単語を学習できます。

提案では、月ごとのプライベートカードの上限を一切消費しないため、単語を提案しても、自分用に作りたいカードの枠が減ることはありません。（ただし、1 日に Inoh に作成を依頼できる回数は、全種類を合わせて 100 回までです。この上限は、暴走したスクリプトへの対策であり、あなたの利用を制限するためのものではありません。）

どちらを依頼するか：

目的	依頼するもの	利用できるまで
今日、自分のデッキに単語を入れたい	自分専用のカード	約 1 分（必ず作成されます）
Inoh の全ユーザー向けに単語を登録したい	リクエスト	数日（承認された場合）

両方行っても問題ありません。今すぐ自分用のカードを作り、同じ単語を提案することもできます。辞書にその単語がすでにある場合、投稿する内容はないため、AI は既存のカードを提示します。別の語義を指していると伝えれば、その場合もリクエストを送信できます。

「提案はどうなった？」と尋ねると、check_card_status が両方の種類の状況をまとめて返します。自分用のカードは準備完了と表示され、提案はレビュアー確認中、公開済み、または却下と表示されます。アプリの「My Requests」画面にも同じ一覧が表示されます。

プライバシーとデータの取り扱い

• サーバー自体には何も保存されません。 アクセストークンを使用してあなたの Inoh アカウント上で操作し、読み書きするデータはすべて、データベースの行レベルセキュリティによってあなたのデータに限定されます。
• 管理者の認証情報は保持しません。 ここにサービスロールキーはないため、ツールにバグがあっても、あなた自身のデータ以外にはアクセスできません。
• カードの内容、リクエスト本文、トークンは記録しません。 ログに記録されるのは、起動時の行、拒否されたオリジン、予期しないエラーのみです。
• カードを作成すると、単語と説明した語義が Inoh のカード作成パイプラインに送信されます。 このパイプラインでは、テキストに OpenAI、音声に Google Cloud、画像に Google Gemini を使用します。あなたに関するそれ以外の情報は送信されません。
• 公開辞書に提案した単語は、あなたが書いた語義とともに Inoh の担当者が確認します。 内容を審査するためです。公開されたエントリーから、誰が提案したかをたどることはできません。
• カードの所有者はあなたです。 カードを削除すると、同じファイルを別のカードも正当に共有している場合を除き、元のメディアも削除されます。
• Inoh アカウントからいつでもアクセスを取り消せます。 取り消した後に、ここにデータが残ることはありません。

セキュリティ

リクエストの認証には OAuth 2.1 のベアラートークンを使用します。認証されていないリクエストには、サーバーの保護されたリソースのメタデータを示す 401 が返されます。MCP クライアントはこれを使ってサインインのフローを検出します。また、/mcp エンドポイントでは Origin ヘッダーも検証するため、Web ページからブラウザー経由でサーバーを操作することはできません。

問題を見つけましたか？ このリポジトリで issue を作成してください。

ライセンス

MCP サーバーのソースは、あなたのアカウントでどのような処理が行われるかを監査できるよう公開されていますが、すべての権利は留保されています。LICENSE を参照してください。ホストされたサーバーへの接続にライセンスは必要ありません。

単独で使用できる plugins/grok-bot/ のプラグインと .cursor-plugin/marketplace.json は、MIT License に基づいてライセンスされています。この例外はサーバーのソースには適用されません。

プッシュチェック

プルリクエストのマージや直接のプッシュを含め、main へのプッシュごとに、GitHub Actions でプッシュチェックワークフローが開始されます。品質ジョブではフォーマットと lint をチェックします。AI ジョブでは、このリポジトリの CLAUDE.md と Actions シークレットの ANTHROPIC_API_KEY を使用して、変更されたソースコードをレビューします。これらのチェックは変更が main に反映された後に実行されます。フィーチャーブランチへのプッシュでは開始されません。

品質チェックに失敗するか、AI レビューで修正なしの指摘が報告された場合は、Actions の実行内容を確認し、追加の修正を行ってください。Claude がコードを編集すると、Actions がその編集内容を検証し、main を対象とする ai-fix/* プルリクエストを作成します。修正プルリクエストがシグナルとなるため、AI ジョブは成功のままです。修正できない問題が見つかった場合に限り、レビューは失敗となります。そのプルリクエストを手動でレビューしてマージしてください。

AI 修正プルリクエストが開いている間に main が更新された場合、次回の AI レビューで未解決の変更と新しいプッシュをあわせて再チェックします。新たにレビューしたコミットから置き換え用のプルリクエストを作成し、古いプルリクエストを閉じます。修正が不要になった場合は古いプルリクエストを閉じます。レビューに失敗した場合は、古いプルリクエストを開いたままにします。AI 修正プルリクエストでは、この main 専用ワークフローは実行されません。そのため、置き換え用のプルリクエストが最新の main と一致していることを確認し、マージ前に競合を解決してください。マージすると、新しいプッシュチェックが開始されます。