MCP Sigmund

🚀 MCP Sigmund

金融データの分析と学習のためのモデルコンテキストプロトコル（MCP）サーバーです。統一されたPostgreSQLデータベースを主要なデータソースとして使用し、進行的開示によるインテリジェントなフォーマットを備え、最適なユーザー体験を提供します。

🚀 クイックスタート

インストールが完了したら、以下の基本的なクエリを使用してMCP Sigmundを使い始めることができます。

• "Show me my balance" - 現在の口座残高を取得します。
• "List my recent transactions" - 最近の取引履歴を表示します。
• "Analyze my spending" - カテゴリ別の支出分析を取得します。
• "What providers do I have?" - 接続されている銀行プロバイダーを一覧表示します。

詳細な使用方法、例、および高度な機能については、ユーザーガイドを参照してください。

✨ 主な機能

• 🗄️ データベース駆動 - 正規化された銀行データを持つPostgreSQLデータベースを主要なデータソースとして使用します。
• 🏦 複数プロバイダー対応 - 複数のオープンバンキングソース（銀行やアグリゲーター）からの統一データを扱います。
• 🎯 スマートフォーマット - 進行的開示によるインテリジェントなデフォルト設定で、最適なユーザー体験を実現します。
• 🔄 コンテキスト検出 - ユーザーの意図に基づいて自動的にフォーマットを調整します。
• 🌐 すべてのプロバイダーをデフォルトとする - プロバイダーが指定されない場合、デフォルトですべてのプロバイダーを対象にクエリを実行します。
• 🛡️ 包括的なエラーハンドリング - 堅牢な検証とエラー管理を行います。
• ✅ 完全なテストカバレッジ - 信頼性を確保するための単体テストと統合テストがあります。
• 📝 TypeScript対応 - 包括的な型定義による型安全な開発が可能です。
• 🔐 安全な設定 - 資格情報保護を備えた集中認証システムです。
• 🔒 セキュリティ機能 - パスワードのサニタイズ、入力検証、および安全なロギングを行います。
• 📊 構造化ロギング - コンテキストとエラー追跡を備えた包括的なロギングを行います。
• ⚡ パフォーマンスモニタリング - クエリのパフォーマンス追跡とヘルスモニタリングを行います。

📦 インストール

1. このリポジトリをクローンします。

git clone <repository-url>
cd mcp-sigmund

2. 依存関係をインストールします。

npm install

3. データベースをセットアップします。

   オプションA: データベースダンプからインポート（推奨）

   # データベースを作成します
   createdb mcp-sigmund
   
   # 提供されたデータベースダンプをインポートします
   psql -d mcp-sigmund -f mcp-sigmund-dump.sql
   

   オプションB: 既存のデータベースを使用する

   • PostgreSQLデータベースに必要なスキーマが含まれていることを確認してください（データベースドキュメントを参照）
   • 設定ファイルの接続文字列を更新してください

4. データベース接続を設定します。

   • src/auth.example.ts を src/auth.ts にコピーします。
   • src/auth.ts のPostgreSQL接続文字列を更新します。

     connectionString: "postgresql://username:password@host:port/database"
     

   • 必要に応じて接続プールの設定を調整します。

5. プロジェクトをビルドします。

npm run build

6. すべてが正常に動作することを確認するためにテストを実行します。

npm test

📚 ドキュメント

• ユーザーガイド - 設定、ツール、および例を含む完全なユーザーガイドです。
• 開発ガイド - 開発者向けのドキュメント、テスト、およびコントリビューションガイドラインです。
• データベースドキュメント - データベースのセットアップ、スキーマ、およびインポート手順です。
• ロードマップ - 将来の開発計画と機能のロードマップです。
• 次のステップ - 直近のアクションアイテムと実装詳細です。

概要

MCP Sigmundは、モデルコンテキストプロトコルを介してAIアシスタント（Claudeなど）が金融データとやり取りできるようにします。APIベースのソリューションとは異なり、このサーバーは事前にデータが入力されたPostgreSQLデータベースを使用しており、そのデータはオープンバンキングソース（ドイツ銀行などの銀行から直接、またはTrueLayerやTinkなどのアカウントアグリゲーターを介して）からインポートされた金融データです。また、ユーザーのコンテキストに自動的に適応するスマートなフォーマットが備わっています。

⚠️ 重要な法的免責事項

MCP Sigmundは教育用の学習リソースおよびデータ分析ツールであり、金融アドバイザーまたはアドバイザリーサービスではありません。

🚫 金融アドバイスではありません

• このシステムは金融アドバイス、推奨事項、またはガイダンスを提供しません。
• すべての洞察、分析、および提案は教育目的のみを意図しています。
• ユーザーは自身の調査と判断に基づいて独自の金融上の決定を行う必要があります。
• このシステムからの情報は、投資、税務、または金融アドバイスとして考慮されるべきではありません。

📚 教育目的のみ

• MCP Sigmundは、個人の金融データを理解するための学習リソースとして設計されています。
• このシステムはユーザーが自身の金融パターンとトレンドを分析し理解するのを支援します。
• すべての出力は教育および情報提供を目的としています。
• ユーザーは実際の金融アドバイスについては適格な金融専門家に相談する必要があります。

MCP Sigmundを使用することで、これが教育ツールであり、金融アドバイザリーサービスではないことを承認するものとします。

📄 ライセンス

ISCライセンス - 詳細についてはLICENSEファイルを参照してください。

免責事項

このプロジェクトは教育および開発目的です。自己責任で使用し、関連する金融規制とデータプライバシー要件に準拠することを確認してください。