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を閉じて再起動します。

💻 使用例

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. リポジトリをフォークする
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キーを取得することを検討してください。