Fonparam MCP

🚀 FonParam MCP Sunucusu

本模型上下文协议（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": ["/完整路径/to/fonparam-mcp/dist/index.js"],
      "env": {}
    }
  }
}

⚠️ 重要提示

从源代码安装时，请将/完整路径/to/fonparam-mcp替换为您项目的实际路径。

4. 重启Claude Desktop

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

💻 使用示例

Claude Desktop中的示例命令：

显示表现最佳的10只基金

列出“ATA PORTFÖY”公司旗下的基金

对比AAK和DAH基金

计算向AAK基金投入10,000里拉，从年初到现在的收益

显示股票型基金本月的表现

显示最新的通胀数据

🔧 技术细节

脚本命令

# TypeScript编译（监听模式）
npm run dev

# 构建项目
npm run build

# 启动服务器
npm start

# 清理编译文件
npm run clean

项目结构

src/
├── index.ts          # 主MCP服务器
├── api-client.ts     # FonParam API客户端
├── tools.ts          # MCP工具定义
└── types.ts          # TypeScript类型定义

🤝 贡献指南

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文档
• 模型上下文协议
• Claude Desktop

⚠️ 重要提示

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

• 每15分钟最多25个请求。
• 每天最多100个请求。

若需大量使用，可考虑获取API密钥。