india-mcp

🇮🇳 India MCP

インドの API とサービス向け MCP（Model Context Protocol）サーバーのコレクションです。Claude、Cursor、OpenCode などの AI エージェントが、リアルタイムデータと専門ツールを活用してインド市場でネイティブに動作できるようにします。

---

🇮🇳 なぜ India-MCP なのか？

インドのデジタルインフラは強力ですが、断片化しています。多くの政府機関や企業のポータルには、次のような課題があります。

• 不安定：断続的なダウンタイムや応答の遅さがあります。
• 保護：特定のヘッダーやセッション管理が必要です。
• 一貫性に欠ける：データ形式（HTML、JSON、XML）がさまざまです。

India-MCP はこれらのサービスを対象に、統一された、堅牢で、AI に最適化されたレイヤーを提供します。単一のプロトコルを通じて、エージェントが本人確認、物流追跡、市場分析、法制度の利用を行えるようにします。

---

🚀 特長

• 本番環境対応：再試行ロジック、リクエストタイムアウト、メモリ内 TTL キャッシュを備えた堅牢なサーバーです。
• 堅牢なデータ取得：可用性を最大化するインテリジェントなフォールバック戦略（例：NSE → Yahoo Finance）を採用しています。
• プライバシー優先：ブラウザー準拠のヘッダーと、API を尊重した利用パターンを採用しています。
• 開発者にやさしい：クリーンな JSON-RPC インターフェースと正規化されたツールの応答を提供します。
• 統一されたエコシステム：銀行、法律、市場データ向けの共通ユーティリティを備えています。

---

🛠 利用可能なサーバー

サーバー	分野	ツール数	説明
GST	税務	5	GSTIN、HSN コード、税額計算を検証します。
Railways	交通	7	列車のリアルタイム状況、PNR 照会、時刻表を提供します。
RTO	自動車	6	車両登録情報と道路税計算ツールを提供します。
Banking	フィンテック	3	IFSC 検索、UPI 検証、銀行の稼働状況確認を提供します。
Stocks	市場	8	NSE/BSE のリアルタイム株価、指数、履歴を提供します。
eCourts	法律	6	裁判所の事件、命令、期日表を取得します。

詳細なカタログ：docs/SERVERS.md | ツールの全一覧：docs/TOOLS.md

---

📦 インストール

npm install -g @samarth-23-eng/india-mcp

クイックスタート — 1 つのコマンドで任意のサーバーを起動できます：

india-mcp stocks       # NSE/BSE stock data
india-mcp gst          # GST validation
india-mcp ecourts      # Court case lookup
india-mcp fssai        # Food license verification
india-mcp list         # Show all available servers
india-mcp --help       # Full usage guide

または、インストールせずに npx を使用できます。

npx @samarth-23-eng/india-mcp stocks

---

🔌 MCP クライアントの設定

Claude Desktop

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "india-stocks": {
      "command": "npx",
      "args": ["-y", "@samarth-23-eng/india-mcp", "stocks"]
    },
    "india-ecourts": {
      "command": "npx",
      "args": ["-y", "@samarth-23-eng/india-mcp", "ecourts"]
    },
    "india-gst": {
      "command": "npx",
      "args": ["-y", "@samarth-23-eng/india-mcp", "gst"]
    }
  }
}

詳細なガイド：docs/EXAMPLES.md

---

🏗 アーキテクチャ

India-MCP は、インドの政府機関ポータルの不安定さに対応するため、共通のレジリエンスレイヤーを使用します。

• 再試行：すべてのネットワーク呼び出しで、指数バックオフによる 2 回の再試行を行います。
• キャッシュ：IP ブロックを防ぐため、TTL ベースのメモリキャッシュを使用します。
• フォールバック：バックアップデータソースに自動的に切り替えます。

技術的な詳細：docs/ARCHITECTURE.md

---

🛤 ロードマップ

予定されているサーバー：

• eCourts（拡張）：最高裁判所および高等裁判所に特化したフィルター。
• FSSAI：食品ライセンスの検証。
• CDSCO：医薬品登録情報の検証。
• 土地記録：デジタル Bhulekh へのアクセス。

---

🚀 リリースプロセス

1. バージョンを更新：npm version patch --no-git-tag-version
2. ビルド：npm run build
3. 検証：npm run validate:publish
4. npm に公開：npm publish --access public
5. レジストリ：mcp-publisher validate と mcp-publisher publish を実行します。

---

🤝 貢献

貢献を歓迎します！始めるには、貢献ガイドラインをお読みください。

---

📄 ライセンス

MIT © Samarth-23-eng