Eco Policy MCP

eco-policy-mcp

インドの金融データ向けMCP サーバー — 投資信託のNAV、GSTおよび所得税の計算ツール、RBIの政策金利、NSEの市場データを提供します。特定のクライアントだけでなく、あらゆるMCPクライアント（Claude、Cursor、Gemini CLI、VS Code、Cline、カスタムエージェントなど）で利用できます。

正常に処理されたすべてのレスポンスにはデータの出典情報（source、as_of、reference）が含まれるため、AI エージェントは数値の出典を引用でき、内容を捏造せずに済みます。

リンク

リソース	URL
GitHubリポジトリ	https://github.com/Akhilesh-Chandewar/eco-policy-mcp
PyPIパッケージ	https://pypi.org/project/eco-policy-mcp/
MCP Registry名	io.github.Akhilesh-Chandewar/eco-policy-mcp（registry.modelcontextprotocol.ioで公開中）
リリース	https://github.com/Akhilesh-Chandewar/eco-policy-mcp/releases
イシュー	https://github.com/Akhilesh-Chandewar/eco-policy-mcp/issues
ライセンス	MIT

インストールと実行

# Run with any MCP client via uvx (installs automatically from PyPI):
uvx eco-policy-mcp

# Or pin the version:
uvx [email protected]

# From a clone:
uv sync
uv run eco-policy-mcp            # stdio (default, local clients)
uv run eco-policy-mcp --http --port 8000   # streamable-HTTP (remote clients)

クライアントの設定（Claude Desktop、Cursor、Gemini CLI、VS Code、リモートHTTP）については、examples/をご覧ください。

ツール

分野	ツール	説明
GST	gst_split	金額と税率に基づいてCGST／SGSTとIGSTを計算
GST	gst_from_inclusive	税込み金額からGSTを算出
GST	gst_reverse_charge	リバースチャージ（RCM）で支払う税額を計算
GST	gstin_validate	GSTINのmod-36チェックサム検証と州コードの確認
所得税	income_tax_new_regime	2026-27年度の新制度による税額の試算（標準控除と87A還付を含む）
所得税	income_tax_old_regime	旧制度による税額の試算（80C、年齢に応じた非課税枠）
所得税	income_tax_compare_regimes	新制度と旧制度を比較して推奨を提示
投資信託	mf_search_schemes	AMFIの全スキームを名称で検索
投資信託	mf_get_nav	スキームコードに対応する最新NAVを取得
投資信託	mf_get_nav_history	指定期間の過去のNAVを取得
投資信託	mf_compute_returns	指定期間の絶対リターンとCAGRを計算
投資信託	mf_sip_calculator	実際のNAVとXIRRを用いてSIPをシミュレーション
RBI	rbi_get_policy_rates	レポ金利、SDF、MSF、銀行金利、CRR、SLRを取得（基準日付き）
NSE	nse_get_quote	株式の気配値を取得（非公式の公開エンドポイント）
NSE	nse_get_index_quote	指数のスナップショットを取得（NIFTY 50、BANK、ITなど）
NSE	nse_get_historical	日次OHLCVを取得（最大1年間）
サーバー	eco_server_info	バージョン、ツール一覧、キャッシュの状態を取得

さらに、リソース（eco-policy://amfi/freshness、eco-policy://rbi/policy-rates）とプロンプト（compare_mutual_funds、gst_invoice_breakup）も提供します。

データソースと免責事項

• AMFI（NAVAll.txt）— 公式の日次NAVデータ。解析して6時間キャッシュします。
• mfapi.in — AMFIのNAVアーカイブを提供するコミュニティ運営のミラー（履歴、リターン、SIP）。
• RBI — 基準日を記録した、厳選された政策金利のスナップショットです。利用前にRBI公式サイトでご確認ください。
• NSE — 非公式の公開エンドポイントです。気配値が遅延する場合があり、エンドポイントは予告なく変更される可能性があります。エラー時には構造化されたエラーを返し、生のHTMLは返しません。
• 税額計算は概算です（追加税および特別税率が適用されるキャピタルゲインは含まれません）。ここに記載された内容は、投資や税務に関する助言ではありません。

設定

すべての設定は環境変数（プレフィックスはECO_）で行います：ECO_TTL_AMFI_INDEX、ECO_TTL_NSE_QUOTE、ECO_NSE_MIN_INTERVAL、ECO_HTTP_TIMEOUT、ECO_MFAPI_BASE、ECO_NSE_BASE、ECO_AMFI_NAV_URL、... 詳しくはsrc/eco_policy_mcp/config.pyをご覧ください。

開発

uv sync --dev          # install with dev tools
uv run pytest          # run the test suite (no network needed)

ライセンス

MIT — LICENSEをご覧ください。