MF MCP服务器
印度共同基金的生产就绪模型上下文协议（MCP）服务器，提供全面的NAV历史、技术指标和筛选能力。
特性
🔍 基金发现与信息
- 搜索共同基金 按名称、AMC或类别
- 列出所有可用资金 带分页
- 获取详细的资金信息 包括元数据和性能摘要
- 检索最新导航 进行变更计算
📈 技术分析
- 完整的指标套件：SMA、EMA、RSI、MACD、布林带、ROC、波动率、下跌
- 滚动退货 在可配置的时间段内（30天、90天、180天、365天）
- 信号发生 看涨/看跌/中性分类
- 趋势和动量分析
📊 高级功能
- 资金比较 跨多个性能和技术指标
- 自定义筛选 具有灵活的基于规则的过滤
- 历史导航数据 具有日期范围过滤功能
- 性能分析 采用风险调整指标
🚀 企业级就绪
- 稳健的错误处理 使用用户友好的消息
- 内存缓存 带可配置TTL
- 请求超时 重试逻辑
- TypeScript 具有全面的类型安全性
- Zod验证 对于所有输入
支持的工具
| 工具 | 说明 |
|---|---|
search_mutual_funds | 按名称、AMC、类别搜索方案 |
list_mutual_funds | 所有可用资金的分页列表 |
get_mutual_fund_details | 详细的资金信息和元数据 |
get_latest_nav | 当前NAV与变化计算 |
get_nav_history | 具有过滤功能的历史导航数据 |
compute_indicators | 技术指标和信号 |
compare_mutual_funds | 并排基金比较 |
screen_mutual_funds | 基于规则的资金筛选 |
建筑
src/
├── index.ts # Application entry point
├── server.ts # MCP server setup and tool registration
├── config/
│ └── env.ts # Environment configuration
├── tools/ # MCP tool implementations
├── services/ # Business logic layer
├── providers/ # Data provider integrations
├── analytics/ # Technical indicator calculations
├── utils/ # Utility functions
└── types/ # TypeScript type definitions快速开始
安装
git clone
cd mf-mcp-server
npm install环境设置
cp .env.example .env
# Edit .env file with your configuration发展
npm run dev生产构建
npm run build
npm start环境变量
# MCP Server Configuration
NODE_ENV=development
LOG_LEVEL=info
# API Configuration
MFAPI_BASE_URL=https://api.mfapi.in
MFAPI_TIMEOUT=10000
CACHE_TTL_SECONDS=300
# Rate limiting
REQUESTS_PER_MINUTE=60Claude桌面配置
将此添加到您的Claude Desktop配置中：
{
"mcpServers": {
"mf-mcp-server": {
"command": "node",
"args": ["/path/to/mf-mcp-server/dist/index.js"],
"env": {
"NODE_ENV": "production"
}
}
}
}对于TypeScript的开发：
{
"mcpServers": {
"mf-mcp-server": {
"command": "npx",
"args": ["tsx", "/path/to/mf-mcp-server/src/index.ts"],
"cwd": "/path/to/mf-mcp-server"
}
}
}用法示例
搜索资金
Search for HDFC equity funds with a limit of 5 results获取技术指标
Compute RSI, MACD, and Bollinger Bands for scheme code 119551筛选高绩效基金
Find funds with RSI 15%, and volatility < 20%比较基金业绩
Compare schemes 119551, 120503, and 118989 across returns, volatility, and signals技术指标
移动平均值
- 简单移动平均线（SMA）：趋势识别
- 指数移动平均线（EMA）：响应性趋势分析
动量振荡器
- RSI（相对强弱指数）：超买/超卖情况
- 变化率（ROC）：动量测量
趋势分析
- 指数平滑异同移动平均线：移动平均收敛发散
- 布林带：基于波动的支撑/阻力
风险指标
- 标准差：波动性测量
- 最大跌幅：下行风险评估
- 滚动退货：在多个时间范围内的性能
数据源
主：MFAPI（api.MFAPI.in）
- 实时导航数据
- 历史价格系列
- 方案元数据
- 免费公众API，覆盖范围广
计划：AMFI集成
- 增强的基金元数据
- 类别分类
- 监管信息
- 后备数据源
性能和限制
缓存策略
- 默认TTL：大多数数据需要5分钟
- 最新NAV：1分钟TTL
- 历史数据：10分钟TTL
- 基金列表：30分钟TTL
API费率限制
- 默认：每分钟60个请求
- 重试逻辑：3次指数回退尝试
- 超时：每个请求10秒
数据限制
- 基于资产净值的分析（不适用于日内交易）
- 基础数据有限（市盈率、持股量不可用）
- 历史数据可用性因基金而异
- 技术分析需要至少50个数据点
发展
脚本
npm run dev # Development with hot reload
npm run build # Production build
npm start # Run production build
npm run lint # ESLint checks
npm run lint:fix # Fix linting issues
npm run type-check # TypeScript type checking测试
# Manual testing with Claude Desktop or MCP inspector
npx @modelcontextprotocol/inspector build/index.js代码质量
- TypeScript：严格模式已启用
- 埃斯林特：代码质量和一致性
- 黄道带：运行时类型验证
- 错误处理：综合误差边界
路线图
第1阶段（当前）
- ✅ 核心MCP工具实施
- ✅ 技术指标
- ✅ 资金筛选
- ✅ MFAPI集成
第二阶段（计划中）
- \[\]AMFI数据集成
- \[\]投资组合分析工具
- \[\]费用比率比较
- \[\]基金经理分析
第三阶段（未来）
- \[\]实时市场数据
- \[\]持股分析
- \[\]部门分配工具
- \[\]风险调整指标（Sharpe、Sortino）
重要免责声明
⚠️ 投资咨询警告：此工具仅供参考，不构成投资建议。仅基于资产净值数据的共同基金技术分析存在局限性：
- 资产净值与市场价格：共同基金以资产净值而非市场价格进行交易
- 每日频率：大多数指标都是为高频数据设计的
- 基本焦点：长期共同基金的业绩更多地取决于基础持股，而不是技术模式
- 市场背景：技术信号应与基本面分析和市场状况一并考虑
在做出投资决策之前，始终咨询合格的财务顾问。
贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
支持
______________________________________________________________________
🔥 生成于 克劳德代码