Mf MCP Server

MF MCP服务器

印度共同基金的生产就绪模型上下文协议（MCP）服务器，提供全面的NAV历史、技术指标和筛选能力。

特性

🔍 基金发现与信息

• 搜索共同基金 按名称、AMC或类别
• 列出所有可用资金 带分页
• 获取详细的资金信息 包括元数据和性能摘要
• 检索最新导航 进行变更计算

📈 技术分析

• 完整的指标套件：SMA、EMA、RSI、MACD、布林带、ROC、波动率、下跌
• 滚动退货 在可配置的时间段内（30天、90天、180天、365天）
• 信号发生 看涨/看跌/中性分类
• 趋势和动量分析

📊 高级功能

• 资金比较 跨多个性能和技术指标
• 自定义筛选 具有灵活的基于规则的过滤
• 历史导航数据 具有日期范围过滤功能
• 性能分析 采用风险调整指标

🚀 企业级就绪

• 稳健的错误处理 使用用户友好的消息
• 内存缓存 带可配置TTL
• 请求超时 重试逻辑
• TypeScript 具有全面的类型安全性
• Zod验证 对于所有输入

支持的工具

建筑

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=60

Claude桌面配置

将此添加到您的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）

重要免责声明

⚠️ 投资咨询警告：此工具仅供参考，不构成投资建议。仅基于资产净值数据的共同基金技术分析存在局限性：

• 资产净值与市场价格：共同基金以资产净值而非市场价格进行交易
• 每日频率：大多数指标都是为高频数据设计的
• 基本焦点：长期共同基金的业绩更多地取决于基础持股，而不是技术模式
• 市场背景：技术信号应与基本面分析和市场状况一并考虑

在做出投资决策之前，始终咨询合格的财务顾问。

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

• 📚 MCP文件
• 🐛 报告问题
• 💬 讨论

______________________________________________________________________

🔥 生成于 克劳德代码