Fonparam MCP

📊 FonParam MCP 服务器

此 Model Context Protocol（MCP）服务器可让 Claude Desktop 访问土耳其的投资基金数据。您可以通过 FonParam API 获取基金的最新数据、业绩统计信息和比较结果。

✨ 功能

• 📈 基金列表：筛选和搜索所有投资基金
• 🔍 基金比较：比较 2-5 只基金并进行分析
• 📊 业绩分析：分析基金投资并计算收益
• 🏢 公司信息：投资组合管理公司及其统计信息
• 📈 历史数据：基金的历史业绩数据
• 📊 统计信息：每日市场统计信息
• 💰 通胀数据：土耳其通胀率

🚀 安装

选项 1：使用 NPM 安装（推荐）

NPM 包会自动运行，因此无需单独安装。您可以在 Claude Desktop 配置中使用 npx 运行该包。

选项 2：从源代码安装

1. 安装依赖项

npm install

2. 构建项目

npm run build

Claude Desktop 配置

将以下配置添加到 Claude Desktop 的 claude_desktop_config.json 文件中：

Windows：

%APPDATA%\Claude\claude_desktop_config.json

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

Linux：

~/.config/Claude/claude_desktop_config.json

配置：

如果使用 NPM 包（推荐）：

{
  "mcpServers": {
    "fonparam": {
      "command": "npx",
      "args": ["-y", "fonparam-mcp"],
      "env": {}
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "fonparam": {
      "command": "node",
      "args": ["/tam/yol/to/fonparam-mcp/dist/index.js"],
      "env": {}
    }
  }
}

注意：从源代码安装时，请将 /tam/yol/to/fonparam-mcp 替换为项目的实际路径。

4. 重启 Claude Desktop

添加配置后，关闭并重新打开 Claude Desktop。

🛠️ 可用工具

📊 基金工具

• list_funds：列出并筛选基金
• top_performing_funds：获取业绩最佳的基金
• compare_funds：比较基金（2-5 只）
• analyze_fund：分析基金投资
• fund_historical_data：获取基金的历史价值

🏢 公司工具

• list_companies：列出投资组合管理公司
• company_details：获取公司详情

📈 统计工具

• statistics：列出每日统计信息
• latest_statistics：获取最新统计信息
• statistics_by_date：获取指定日期的统计信息

🎯 基金类型工具

• list_fund_types：列出基金类型
• fund_type_details：获取基金类型详情

💰 通胀工具

• inflation_rates：列出通胀数据
• latest_inflation_rate：获取最新通胀数据
• monthly_inflation_rate：获取指定月份/年份的通胀数据

💡 使用示例

在 Claude Desktop 中的示例命令：

En iyi performans gösteren 10 fonu göster

"ATA PORTFÖY" şirketine ait fonları listele

AAK ve DAH fonlarını karşılaştır

AAK fonuna 10.000 TL yatırıp yıl başından bugüne kadar kaç para olacağını hesapla

Hisse senedi fonlarının bu ayki performansını göster

Son enflasyon verilerini göster

🔧 开发

Scripts

# TypeScript derlemesi (watch mode)
npm run dev

# Projeyi derle
npm run build

# Sunucuyu başlat
npm start

# Derleme dosyalarını temizle
npm run clean

项目结构

src/
├── index.ts          # Ana MCP sunucusu
├── api-client.ts     # FonParam API client
├── tools.ts          # MCP araçları tanımları
└── types.ts          # TypeScript tip tanımları

🤝 参与贡献

1. Fork 仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'feat: amazing new feature'）
4. 推送分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

📜 许可证

本项目采用 MIT 许可证。

🔗 链接

• FonParam API 文档
• Model Context Protocol
• Claude Desktop

⚠️ 注意

此服务器使用 FonParam API 的免费层，并受速率限制规则约束：

• 15 分钟内最多 25 次请求
• 每日最多 100 次请求

如果使用频繁，可以考虑获取 API 密钥。