Cbn MCP

🚀 CBN MCP Server 🏦

このサーバーは、ナイジェリア中央銀行（CBN）のデータと通達にアクセスするためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーをCursor、Claude Desktop、またはMCP互換のアプリケーションに接続することで、AIチャットで直接CBNの規制情報にアクセスできます。🚀

mcp_server_dartで構築 - 私が作成した、アノテーションとコード生成機能を備えた開発者にやさしいDart用MCPフレームワークです。💪

✨ 主な機能

🛠️ MCPツール

📋 通達ツール

• getAllCirculars：日付範囲とカテゴリでのオプションフィルタリングを使用して、すべてのCBN通達を取得します。📋
• getCircularById：IDで特定のCBN通達を取得します。🔍
• searchCirculars：タイトルまたは説明のキーワードでCBN通達を検索します。🔎
• fetchCircularPdf：CBN通達のPDFコンテンツをダウンロードして読み取ります。📄
• fetchCircularPdfById：通達IDでPDFコンテンツをダウンロードします。📥
• getCircularPdfUrl：IDでCBN通達のPDFの直接ダウンロードURLを取得します。🔗
• getCircularsForLLMAnalysis：LLM分析用にフォーマットされたPDF URL付きの最新のCBN通達を取得します。🤖

💱 為替レートツール

• getAllExchangeRates：日付範囲と通貨でのオプションフィルタリングを使用して、すべてのCBN為替レートを取得します。💱
• getExchangeRateById：IDで特定のCBN為替レートを取得します。🔍

📊 金融データツール

• getAllFinancialData：日付範囲と金融指標でのオプションフィルタリングを使用して、すべてのCBN金融データを取得します。📊
• getFinancialDataById：IDで特定のCBN金融データを取得します。🔍

📚 MCPリソース

• cbnApiStatus：CBN API接続の現在のステータスと健全性。💚
• serverInfo：このCBN MCPサーバーに関する情報。ℹ️
• availableCircularPdfs：URI付きの利用可能な通達PDFのリスト。📄
• randomFact：CBNに関するランダムな事実。🎲

💬 MCPプロンプト

• circularSummary：CBN通達分析用の要約プロンプトを生成します。📊
• regulatoryAnalysis：CBN通達の規制遵守分析用のプロンプトを生成します。⚖️

🚀 クイックスタート

⚡ オプション1: 事前ビルド済みバイナリをダウンロードする（最も簡単）

1. Releasesにアクセスします。📦
2. cbn_mcp実行ファイルをダウンロードします。⬇️
3. 実行可能にする：chmod +x cbn_mcp 🔧
4. パスを使用する：/path/to/cbn_mcp 📁

🎯 オプション2: Dartで実行する（Dartがインストールされている場合）

1. このリポジトリをクローンする：git clone https://github.com/chiziaruhoma/cbn_mcp.git 📂
2. ディレクトリに移動する：cd cbn_mcp 📍
3. 依存関係をインストールする：dart pub get 📦
4. コマンドを使用する：dart run bin/main.dart ▶️

🔨 オプション3: ソースからビルドする

1. オプション2の手順1 - 3に従います。⬆️
2. 実行ファイルをビルドする：dart compile exe bin/main.dart -o cbn_mcp 🏗️
3. パスを使用する：/path/to/cbn_mcp 📁

🤖 AIアプリケーションとの統合

💻 Cursor IDE

1. Cursorの設定を開きます（Cmd/Ctrl + ,）。⚙️

2. "Features" → "Model Context Protocol"に移動します。🔧

3. 以下のいずれかの設定で新しいMCPサーバーを追加します。📝

   事前ビルド済みバイナリを使用する場合： ⚡

   {
     "name": "cbn-mcp",
     "command": "/path/to/cbn_mcp"
   }
   

   Dartを使用する場合（Dartがインストールされている場合）： 🎯

   {
     "name": "cbn-mcp",
     "command": "dart",
     "args": ["run", "bin/main.dart"],
     "cwd": "/path/to/cbn_mcp"
   }
   

4. Cursorを再起動します。🔄

5. これで、「最新のCBN通達は何ですか？」や「外国為替取引に関するCBN規制を見つけてください」などの質問ができます。💬

🖥️ Claude Desktop

1. Claude Desktopの設定を開きます。⚙️

2. MCPサーバーの構成に移動します。🔧

3. 以下のいずれかの設定でCBN MCPサーバーを追加します。📝

   事前ビルド済みバイナリを使用する場合： ⚡

   {
     "mcpServers": {
       "cbn-mcp": {
         "command": "/path/to/cbn_mcp"
       }
     }
   }
   

   Dartを使用する場合（Dartがインストールされている場合）： 🎯

   {
     "mcpServers": {
       "cbn-mcp": {
         "command": "dart",
         "args": ["run", "bin/main.dart"],
         "cwd": "/path/to/cbn_mcp"
       }
     }
   }
   

4. Claude Desktopを再起動します。🔄

5. 会話でCBNツールが使用可能になります。🎉

🌐 その他のMCP互換アプリケーション

MCPをサポートするすべてのアプリケーションに対して：🔌

1. cbn_mcp実行ファイルを指すサーバー構成を追加します。📝
2. サーバーは、AIアシスタントにCBNデータアクセスツールを公開します。🤖

💻 使用例

統合後、AIアシスタントに以下のような質問をすることができます。🗣️

📋 通達の例

• "今月の最新のCBN通達は何ですか？" 📅
• "暗号通貨に関連するすべてのCBN規制を見つけてください" 💰
• "CBN通達BSD/DIR/GEN/LAB/11/020の詳細を教えてください" 🔍
• "最近のCBN通貨政策通達の要点を要約してください" 📊
• "最近のCBN通達に基づく銀行の遵守要件は何ですか？" ⚖️

💱 為替レートの例

• "現在のUSD/NGN為替レートは何ですか？" 💵
• "過去1週間の為替レートを見せてください" 📈
• "CBN公式のEURからNGNへのレートを取得してください" 💶

📊 金融データの例

• "現在のCBN通貨政策パラメーターは何ですか？" 🏛️
• "先月のレポレートを見せてください" 📊
• "現在の現金準備率は何ですか？" 💰
• "今四半期の期初残高データを取得してください" 📅

👨‍💻 開発

📋 前提条件

• Dart SDK ^3.9.2
• Git

🛠️ セットアップ

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

   git clone https://github.com/chiziaruhoma/cbn_mcp.git
   cd cbn_mcp
   

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

   dart pub get
   

3. マッピング可能なクラスを生成します（必要な場合）。

   dart run build_runner build
   

▶️ サーバーの実行

# Dartで直接実行
dart run bin/main.dart

# または、実行ファイルをビルドして実行
dart compile exe bin/main.dart -o cbn_mcp
./cbn_mcp

🧪 テスト

dart test

📦 配布用のビルド

# 実行ファイルをビルド
dart compile exe bin/main.dart -o cbn_mcp

# 実行ファイルは、互換性のあるシステムで配布および実行できます

📁 プロジェクト構造

lib/
├── cbn.dart              # メインのMCPサーバークラス
├── cbn.mcp.dart          # 生成されたMCPアノテーション
├── core/
│   ├── api/
│   │   └── api_client.dart    # CBN API用のHTTPクライアント
│   └── utils/
│       └── logger.dart        # ログ記録ユーティリティ
├── models/               # マッピング可能なアノテーション付きのデータモデル
│   ├── circular.dart     # 通達データモデル
│   ├── financials.dart   # 金融データモデル
│   ├── rates.dart        # 為替レートモデル
│   ├── random.dart       # ランダムな事実モデル
│   └── models.dart       # 基本モデルクラス
└── services/             # ビジネスロジックサービス
    ├── circulars.dart    # 通達APIサービス
    ├── financials.dart   # 金融データサービス
    ├── rates.dart        # 為替レートサービス
    ├── prompt.dart       # MCPプロンプトサービス
    ├── status.dart       # ステータスと情報サービス
    └── services.dart     # 基本サービスクラス

🤝 コントリビュートする方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを開きます。

📖 APIドキュメント

このプロジェクトは、ナイジェリア中央銀行の公開APIと統合されています。利用可能なエンドポイントの詳細については、CBN Developer Portalを参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

🙏 謝辞

• 公開APIを提供してくれたナイジェリア中央銀行
• プロトコル仕様を提供してくれたMCPコミュニティ
• Dart用のMCPフレームワークであるmcp_server_dart