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

🔧 開発

スクリプト

# 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. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'feat: amazing new feature'）
4. ブランチをプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

📜 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。

🔗 リンク

• FonParam API ドキュメント
• Model Context Protocol
• Claude Desktop

⚠️ 注

このサーバーは FonParam API の無料プランを使用しており、レート制限の対象となります。

• 15 分あたり最大 25 件のリクエスト
• 1 日あたり最大 100 件のリクエスト

頻繁に利用する場合は、API キーの取得をご検討ください。