Agentic Ai MCP

🚀 項目設置

本項目主要涉及 UV 安裝、虛擬環境創建、數據填充、MCP 客戶端配置等一系列設置步驟，幫助你快速搭建項目運行環境。

🚀 快速開始

📦 安裝指南

UV 安裝和設置

1. 安裝 UV
   若要安裝 UV，可運行以下命令：

   pip install uv
   

2. 驗證安裝
   運行以下命令確認 UV 已成功安裝：

   uv --version
   

使用 pyproject.toml

1. 創建虛擬環境
   運行以下命令創建虛擬環境：

   python -m venv venv
   

2. 激活虛擬環境

   • 在 Windows 上：

     venv\Scripts\activate
     

   • 在 macOS/Linux 上：

     source venv/bin/activate
     

3. 從 pyproject.toml 安裝依賴項
   使用 pip 根據 pyproject.toml 文件中的說明安裝依賴項：

   pip install .
   

4. 驗證安裝
   確保所有依賴項都已正確安裝：

   pip list
   

5. 運行測試用例
   使用 pytest 確保所有測試用例通過：

   pytest
   

💻 使用示例

填充金融交易數據

執行以下命令以填充示例金融交易數據：

python util/populate_data.py

🔧 技術細節

配置 MCP 客戶端 - Windows 上的Claude

1. 定位樣本配置文件
   使用提供的 config/sample_claude_desktop_config.json 文件作為模板。

2. 複製配置文件
   將文件放在以下目錄中：

   ~\AppData\Roaming\Claude
   

3. 重命名文件
   將文件重命名為 claude_desktop_config.json。

4. 更新配置詳細信息

   • 使用文本編輯器打開 claude_desktop_config.json 文件。
   • 更新 Alpha Vantage API Key 為您自己的密鑰。
   • 更新 數據庫連接詳細信息 為適當的憑據和連接字符串。

🔍 後續操作

重新啟動 Claude Desktop

重新啟動 Claude Desktop，您可能需要從任務管理器中結束任務。注意，一旦重新啟動後：

1. 您應該能夠看到工具數量以及錘子圖標。
2. 這將開始每個工具的背景 Python 程序。