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密鑰。