Ramayana Book MCP Server

ramayana-mcp

ラーマーヤナ書籍用の MCP（Model Context Protocol）サーバーです （svenkatreddy/ramayana-mcp）。 詩句を検索し、 サンスクリット語と英語／ヒンディー語／テルグ語の翻訳を取得したり、日替わりの詩句を決定論的に取得したりできます。同じコードベースで、次の3つのターゲットに対応します。

• stdio (src/stdio.ts) — Claude Desktop、Cursor、および Smithery でのホスティング
• Vercel サーバーレス (api/mcp.ts) — /api/mcp でのステートレスな HTTP 経由の JSON-RPC （依存関係のないハンドラーです。SDK の ESM トランスポートは Vercel のランタイムでクラッシュします）

ツール

ツール	機能
list_kandas	サンスクリット語のタイトルと章数を含む7つのカーンダ
get_verse	カーンダ、サルガ、詩句番号を指定して詩句を1つ取得
get_sarga	1つのサルガの全詩句を取得（言語フィルターは任意）
search_verses	4言語すべてを対象に、スニペット付きで全文検索
verse_of_the_day	決定論的な日替わりの詩句（詳細は以下を参照）

さらに、カーンダ／章／詩句の数を含む ramayana://kandas リソースがあります。

日替わりの詩句

verse_of_the_day は、カレンダーの日付（デフォルトでは UTC の YYYY-MM-DD）をハッシュ化し（FNV-1a）、インデックス化された全24,214詩句の中から均等に詩句を選びます。同じ日付であれば常に同じ詩句が返されます。別の日の詩句を調べるには、明示的に date を渡してください。

ローカルでのセットアップ

npm install
npm run build-index   # builds data/ from a Ramayana_Book checkout
npm run build
npm start             # stdio server

build-index は、RAMAYANA_BOOK_DIR から Ramayana_Book リポジトリを読み込みます（デフォルト：このパッケージから見て ../../ramayana-modernization/repo）。

Claude Desktop の設定（claude_desktop_config.json）：

{
  "mcpServers": {
    "ramayana-book": {
      "command": "node",
      "args": ["/absolute/path/to/ramayana-mcp/dist/src/stdio.js"]
    }
  }
}

Vercel へのデプロイ（無料の Hobby プラン、支払い不要）

1. このディレクトリを新しい GitHub リポジトリにプッシュします（リポジトリは github.com で自分で作成してください）。
2. Vercel のダッシュボードで、Add New Project -> Import the repo -> Deploy を選択します。
3. ビルド設定は不要です。vercel.json により、関数とともに data/ ファイルがすでにデプロイされます。MCP エンドポイントは https://<project>.vercel.app/api/mcp です。

エンドポイントはステートレス（JSON-RPC リクエストごとに POST を1回実行し、セッションはありません）で、Hobby プランの関数制限に適しています。任意の MCP クライアントを上記の URL に接続してください。

Smithery での公開（見つけやすくするため）

1. リポジトリを GitHub に（公開で）プッシュします。完了済み：svenkatreddy/ramayana-mcp。
2. smithery.ai にアクセスし、GitHub でサインインします。
3. ramayana-mcp リポジトリを追加／デプロイします。smithery.yaml で TypeScript ランタイムを宣言しています。Smithery が src/index.ts から createServer と configSchema をインストール、ビルド、インポートします。API キーや設定は不要です。

Smithery がサーバーをホストし、Claude Desktop、Cursor、その他のクライアント向けのワンクリックインストール機能を備えたレジストリページを提供します。

データと帰属表示

詩句データは Ramayana_Book リポジトリを基に構築されています。

• サンスクリット語：Sanskrit Wikisource（Wikimedia）。3章は IIT Kanpur の校訂版から復元
• 英語：Valmiki Ramayan Dataset（MIT）— M.N. Dutt による翻訳（1891-1894）、IIT Kanpur、Gyaandweep
• ヒンディー語：Chaturvedi Dwarka Prasad Sharma によるヒンディー語版ラーマーヤナ（許可を得て使用）
• テルグ語：Telugu Wikisource の貢献者（CC BY-SA）

Ramayana_Book の翻訳に変更があった場合は、npm run build-index を再実行してください。

ライセンス

このリポジトリのサーバーコードは MIT ライセンスです（LICENSE を参照）。

data/ 内の詩句データには、それぞれのソースのライセンスが適用され、MIT ライセンスではありません。 サンスクリット語は Sanskrit Wikisource（Wikimedia）、英語は MIT ライセンスの Valmiki Ramayan Dataset、ヒンディー語は Chaturvedi Dwarka Prasad Sharma による翻訳（許可を得て使用）、テルグ語は Telugu Wikisource の貢献者 （CC BY-SA）に基づいています。帰属表示の詳細については、Ramayana_Book の 翻訳ソースを参照してください。