Mftool Mcp

🇮🇳 mftool-mcp

面向公开可用印度共同基金数据的 MCP 服务
由 mftool 提供支持 · 适用于 Claude、Cursor 及任何兼容 MCP 的大模型客户端

---

这是什么？

mftool-mcp 是一个 Model Context Protocol (MCP) 服务，可让任何大模型客户端访问印度共同基金数据。

你可以向 AI 助手提问，例如：

• “SBI Bluechip Direct Growth 的当前 NAV 是多少？”
• “显示 HDFC Midcap Opportunities Fund 的 3 年回报”
• “列出 Mirae Asset AMC 旗下的所有计划”
• “查找所有灵活市值基金，并比较它们的 5 年回报”

---

可用工具

工具	描述
get_scheme_quote	根据 AMFI 计划代码查询任意计划的实时 NAV
get_bulk_quotes	一次查询多个计划的实时 NAV（并发）
get_scheme_historical_nav	查询某计划的完整 NAV 历史记录（所有可用日期）
get_scheme_historical_nav_for_dates	查询指定日期范围内的 NAV 历史记录（DD-MM-YYYY）
get_scheme_history	通过 BSE/YFinance 代码，按周期或日期范围查询 NAV 历史记录
get_scheme_codes	所有 AMFI 计划代码及名称
get_available_schemes	某 AMC 旗下的所有计划
get_scheme_details	基金管理公司、类型、类别、成立日期（AMFI 代码）
get_scheme_info	丰富的计划信息 — 资产管理规模、回报、评级（BSE/YFinance 代码）
is_valid_scheme_code	验证 AMFI 数字计划代码
is_valid_new_scheme_code	验证 BSE/新格式计划代码
search_schemes	按名称关键词搜索计划，并按相关性排序
search_schemes_by_amc	搜索某 AMC 旗下的计划
search_schemes_by_type	按类型/类别搜索计划（股票、债券、ELSS 等）
get_average_aum	按季度查询所有 AMC 的平均资产管理规模（国内和海外）
get_equity_scheme_performance	所有股票型基金的每日表现（1Y/3Y/5Y 回报）
get_debt_scheme_performance	所有债券型基金的每日表现（1Y/3Y/5Y 回报）
get_hybrid_scheme_performance	所有混合型基金的每日表现（1Y/3Y/5Y 回报）
get_solution_scheme_performance	解决方案导向型基金（退休、儿童）的每日表现
get_other_scheme_performance	指数基金和基金中的基金的每日表现
calculate_returns	计算 SIP 回报 — 绝对回报率和年化 IRR
calculate_balance_units_value	计算某计划所持份额的当前市场价值
calculate_portfolio_value	计算多计划投资组合的当前总价值（并发）
get_cache_stats	查看 NAV 和计划代码缓存的命中/未命中统计数据
clear_cache	清除所有缓存数据，以强制重新获取
set_cache_enabled	全局启用或禁用 mftool 缓存

---

快速开始

使用 uvx（推荐 — 无需安装）

uvx mftool-mcp

使用 pip

pip install mftool-mcp
mftool-mcp

---

Claude Desktop 设置

将以下内容添加到你的 claude_desktop_config.json：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mftool-mcp": {
      "command": "uvx",
      "args": ["mftool-mcp"]
    }
  }
}

重启 Claude Desktop。你会在已连接的工具中看到 mftool-mcp。

---

Cursor / 其他 MCP 客户端

在 MCP 客户端设置中添加：

{
  "mftool-mcp": {
    "command": "uvx",
    "args": ["mftool-mcp"]
  }
}

---

示例对话

查找基金：

你：“查找所有 SBI 中型市值共同基金计划代码”
Claude：调用 search_schemes_by_amc(amc_name='sbi', query='midcap')
Claude：“以下是 SBI 中型市值计划：SBI Magnum Midcap Fund - Direct Growth（代码：125497）……”

实时 NAV：

你：“计划 125497 当前的 NAV 是多少？”
Claude：调用 get_scheme_quote(scheme_code='125497')
Claude：“SBI Magnum Midcap Fund - Direct Growth：NAV ₹234.56（截至 05-Apr-2025）”

业绩比较：

你：“比较大盘股股票基金的 5 年回报率”
Claude：调用 get_equity_scheme_performance()
Claude：“以下是大盘股基金的 5 年回报率比较：……”

---

数据来源

所有数据均通过 mftool 库获取。数据准确性取决于已发布的数据。本工具仅供参考，不构成财务建议。

---

开发

git clone https://github.com/NayakwadiS/mftool-mcp
cd mftool-mcp
pip install -e ".[dev]"

# Run the server locally
python -m mftool_mcp.server

完整的发布流程（PyPI + MCP Registry）请参阅 PUBLISHING.md。

---

致谢

• mftool — 底层数据库

相关项目

• NSE 股票预测 NSE-Neuron