Cbn MCP

🚀 尼日利亞中央銀行（CBN）模型上下文協議（MCP）服務器 🏦

CBN MCP服務器是一個用於訪問尼日利亞中央銀行（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：獲取最近的CBN通告，並附帶適合大語言模型（LLM）分析的PDF URL 🤖

💱 匯率工具

• getAllExchangeRates：獲取所有CBN匯率，可根據日期範圍和貨幣進行篩選 💱
• getExchangeRateById：通過匯率ID獲取特定的CBN匯率 🔍

📊 金融數據工具

• getAllFinancialData：獲取所有CBN金融數據，可根據日期範圍和金融指標進行篩選 📊
• getFinancialDataById：通過金融數據ID獲取特定的CBN金融數據 🔍

📚 MCP資源

• cbnApiStatus：CBN API連接的當前狀態和健康狀況 💚
• serverInfo：此CBN MCP服務器的相關信息 ℹ️
• availableCircularPdfs：可用通告PDF的列表及其URI 📄
• randomFact：一條關於CBN的隨機趣聞 🎲

💬 MCP提示

• circularSummary：生成用於分析CBN通告的摘要提示 📊
• regulatoryAnalysis：生成用於分析CBN通告合規性的提示 ⚖️

🚀 快速開始

⚡ 選項1：下載預構建的二進制文件（最簡單）

1. 訪問 發佈頁面 📦
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. 進入 "功能" → "模型上下文協議" 🔧

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）的匯率是多少？" 💵
• "顯示過去一週的匯率" 📈
• "獲取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開發者門戶。

📄 許可證

本項目採用MIT許可證 - 詳情請參閱 LICENSE 文件。

🙏 致謝

• 尼日利亞中央銀行為我們提供了公共API
• MCP社區制定了協議規範
• mcp_server_dart 提供了Dart MCP框架